Welche Funktionen des Places SDK for Android in Ihrer App verfügbar sind, ergibt sich aus der Kombination der SDK-Versionsnummer (z.B. 3.5.0), die Sie in Ihrer App-Konfiguration angeben, den im API-Schlüssel aktivierten APIs und der Art und Weise, wie Sie Ihre App initialisieren. In diesem Leitfaden werden die Unterschiede zwischen den Versionen erläutert und Sie erfahren, wie Sie die entsprechenden Versionen in Ihrer App auswählen.
SDK-Versionsnummern
Die Versionsnummer des SDKs, das Sie in der build.gradle-Datei auf App-Ebene angeben, bestimmt, ob Ihre App Zugriff auf Funktionen hat, die in einem bestimmten Release hinzugefügt wurden. „Autocomplete (New)“ ist beispielsweise erst ab SDK-Version 3.5.0 verfügbar.
Weitere Informationen zu den Änderungen in den einzelnen SDK-Versionen finden Sie in den Versionshinweisen zum Places SDK for Android.
Places API-Versionen für das Places SDK for Android
Zusätzlich zur SDK-Versionsnummer müssen Sie auch den Places API-Dienst auswählen, den das SDK in der Google Cloud Console aufruft: entweder Places API oder Places API (New). Zusammen mit der SDK-Versionsnummer bestimmt der von Ihnen ausgewählte API-Dienst, welche Version bestimmter Funktionen in Ihrer App verfügbar ist, z. B. „Autocomplete“ oder „Autocomplete (New)“. Sie können zwar nur eine SDK-Versionsnummer angeben, aber die Places API und die Places API (New) für Ihren API-Schlüssel gleichzeitig aktivieren und dann auswählen, welchen Dienst das SDK mit der Methode aufruft, mit der das SDK in Ihrer App initialisiert wird. In den meisten Fällen sollten Sie jedoch die Places API (New) aktivieren und die (neuen) Versionen der SDK-Funktionen in Ihrer App verwenden.
SDK-Version und API-Dienste auswählen
So wählen Sie aus, welche SDK-Funktionen in Ihrer App verfügbar sind:
- Aktivieren Sie in Ihrem Google Cloud-Projekt die Places API, die Places API (New) oder beide. Weitere Informationen finden Sie unter APIs aktivieren.
- Aktivieren Sie in den Einschränkungen für API-Schlüssel die Places API, die Places API (New) oder beide. Weitere Informationen finden Sie unter API-Schlüssel einschränken.
Geben Sie in der build.gradle-Datei auf App-Ebene eine Versionsnummer an. Weitere Informationen finden Sie unter Installation.
Initialisieren Sie die Anwendung, indem Sie die Methode
Places.initializeWithNewPlacesApiEnabled()oderPlaces.initialize()aufrufen.
Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.
SDK-Funktionen, die in den einzelnen Versionen verfügbar sind
In der folgenden Tabelle sehen Sie, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:
| Feature | Places API für API-Schlüssel aktiviert | Initialisierungsmethode | Mindestversion des SDK |
|---|---|---|---|
| Automatische Vervollständigung (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Ortsfotos (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Textsuche (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | Places API | initialize() |
|
| Find Current Place | Places API | initialize() |
|
| Ortsdetails | Places API | initialize() |
|
| Ortsfotos | Places API | initialize() |
Überlegungen zur Auswahl der zu aktivierenden Versionen
Berücksichtigen Sie bei der Entscheidung für eine Version Folgendes:
- Wenn Sie Neukunde sind und gerade erst mit dem Places SDK for Android beginnen, sollten Sie mit der Places API (New) und dem neuen SDK beginnen.
- Wenn Sie bereits Kunde sind, können Sie das vorhandene SDK weiterhin verwenden. Wenn Sie jedoch von den Leistungsverbesserungen und Funktionsoptimierungen des Places SDK for Android (New) profitieren möchten, sollten Sie das neue SDK verwenden. Für die Umstellung auf das neue SDK ist keine Migration erforderlich. Folge einfach den Schritten unter SDK-Version und API-Dienste auswählen.
- Im Places SDK for Android (New) sind Sitzungstokens ab Version 3.5.0 verfügbar. Weitere Informationen finden Sie unter Sitzungstokens.
- Aufrufe über „Place Autocomplete“-Widgets rufen immer Place Autocomplete und nicht „Place Autocomplete (New)“ auf. Widgetaufrufe sind von der Initialisierungsmethode nicht betroffen.
- Bei Place Photos (New) wird nur ein URI zu einem Bitmapbild zurückgegeben, bei Place Photos nur ein Bitmapbild.
- Current Place ist nur im Places SDK for Android verfügbar, nicht im Places SDK for Android (New).
Verbesserungen im Places SDK for Android (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die dem Places SDK for Android (New) hinzugefügt wurden.
Implementierung auf der Google Cloud-Standardplattform
Das Places SDK for Android (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein gewisses Maß an Konsistenz über alle SDKs hinweg, was die Effizienz der Entwicklung mit dem Places SDK for Android (New) verbessert.
Verbesserte Leistung
Das Places SDK for Android (New) bietet eine verbesserte Leistung. Es lohnt sich daher, Apps zu ersetzen, die das vorhandene SDK verwenden.
Neue Funktionen
Das Places SDK for Android (New) enthält die neuesten Versionen aller SDK-Funktionen:
- Automatische Vervollständigung (neu)
- Place Details (neu)
- Nearby Search (neu)
- Ortsfotos (neu)
- Textsuche (neu)
Neuer Dienst „Text Search“
Bei Text Search (New) werden auf Grundlage eines Strings Informationen zu verschiedenen Orten zurückgegeben, z. B. „Pizza in München“, „Schuhgeschäfte in der Nähe von Hamburg“ oder „Hauptstraße 123“. Der Dienst gibt eine Liste von Orten zurück, die dem Textstring und der festgelegten Standortgewichtung entsprechen.
Neue Antwortdaten zu Placed Details (New) und Place Photos (neu) hinzugefügt
Place Details (neu) enthält jetzt die neue Klasse Review im
Place-Antwortobjekt. Die Place-Klasse enthält die neue MethodegetReviews()zur Unterstützung dieses Felds. Rufen SiegetReviews()auf, um bis zu fünf Rezensionen für einen Ort zurückzugeben.Place Photo (Neu) fügt der Klasse
PhotoMetadatadenAuthorAttributionshinzu.AuthorAttributionsenthält eineListmitAuthorAttribution-Objekten.
Neue URI-Antwort zu Place Photos (Neu) hinzugefügt
Sie können jetzt Place Photo (Neu) verwenden, um einen URI zu einer Bild-Bitmap zurückzugeben. Bisher konnte nur die Bild-Bitmap selbst zurückgegeben werden.
Vereinfachte Preisgestaltung
Die Preisgestaltung wurde mit dem Places SDK for Android (New) vereinfacht, sodass Sie nur für die Daten zahlen, die Sie tatsächlich nutzen. Vereinfachte Preise werden mithilfe von Feldlisten implementiert, die auch als Feldmasken bezeichnet werden.
Bei „Place Details“ und „Text Search“ steuern Sie mithilfe von Feldlisten die Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Die Verwendung einer Feldliste hat sich bewährt, um zu verhindern, dass unnötige Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Ausführliche Preisinformationen für beide SDKs finden Sie unter Nutzung und Abrechnung.
Maximierte Ortstypen
Im neuen SDK werden die in der folgenden Tabelle aufgeführten Ortstypen hinzugefügt. Diese Typen werden als Teil der „Place Details“- und „Text Search“-Antwort zurückgegeben. Sie können diese neuen Typen und die vorhandenen Typen auch in einer Suche mit „Text Search“ verwenden. Die neuen Typen sind in Tabelle A enthalten.
| Typ | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | farm | korean_restaurant | sporting_goods_store |
| barber_shop | Bauernhof | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | Markt | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | Schneider |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | Motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| Berater | Hubschrauberlandeplatz | playground | vegetarian_restaurant |
| convention_center | hiking_area | Vorschule | vietnamese_restaurant |
| Hütte | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | Jugendherberge | resort_hotel | Großhändler |
| dental_clinic | hotel | rest_stop |
Neben diesen neuen Typen wurden auch die folgenden Typen für die Places API (New) aus Tabelle 2 nach Tabelle A für die Places API (New) verschoben. Das bedeutet, dass Sie diese Typen jetzt in einer Suche verwenden können:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality