Welche Funktionen des Places SDK for Android für Ihre App verfügbar sind, wird anhand der SDK-Versionsnummer (z.B. 3.5.0), die Sie in der App-Konfiguration angegeben haben, der für Ihren API-Schlüssel aktivierten APIs und der Art der Initialisierung Ihrer App ermittelt. In diesem Leitfaden werden die Unterschiede zwischen den Versionen erläutert und wie Sie auswählen, welche Versionen in Ihrer App aktiviert sind.
SDK-Versionsnummern
Die Versionsnummer des SDKs, die Sie in der Datei „build.gradle“ auf App-Ebene angeben, bestimmt, ob Ihre App Zugriff auf Funktionen hat, die in einem bestimmten Release hinzugefügt wurden. „Autocomplete (neu)“ 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 Angabe einer SDK-Versionsnummer müssen Sie auch den Places API-Dienst auswählen, der vom SDK in der Google Cloud Console aufgerufen wird: entweder die Places API oder die Places API (New). Zusammen mit der SDK-Versionsnummer bestimmt der ausgewählte API-Dienst, welche Version bestimmter Funktionen in Ihrer App verfügbar sind, z. B. „Automatische Vervollständigung“ oder „Automatische Vervollständigung (neu)“. Sie können zwar nur eine SDK-Versionsnummer angeben, aber Sie können sowohl die Places API als auch die Places API (New) für Ihren API-Schlüssel gleichzeitig aktivieren und dann auswählen, welchen Dienst das SDK über die Methode zum Initialisieren des SDK in Ihrer App aufruft. In den meisten Fällen ist es jedoch sinnvoll, die Places API (New) zu aktivieren und die (New) Versionen der SDK-Funktionen in Ihrer App zu 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 Datei „build.gradle“ 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.
In den einzelnen Versionen verfügbare SDK-Funktionen
In der folgenden Tabelle sehen Sie, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:
| Funktion | Places API für API-Schlüssel aktiviert | Initialisierungsmethode | SDK-Mindestversion |
|---|---|---|---|
| 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 |
| Fotos von Orten (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Text Search (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 das Places SDK for Android zum ersten Mal nutzen, empfehlen wir Ihnen, mit der Places API (New) und dem neuen SDK zu beginnen.
- Wenn Sie Bestandskunde sind, können Sie das vorhandene SDK weiterhin verwenden. Sie sollten jedoch das neue SDK verwenden, um von den Leistungsverbesserungen und den Funktionserweiterungen des Places SDK for Android (New) zu profitieren. Für den Wechsel zum neuen SDK ist keine Migration erforderlich. Führen Sie einfach die Schritte unter SDK-Version und API-Dienste auswählen aus.
- Im Places SDK for Android (New) sind Sitzungstokens ab Version 3.5.0 verfügbar. Weitere Informationen finden Sie unter Sitzungstokens.
- Bei Aufrufen mit Place Autocomplete-Widgets wird immer Place Autocomplete aufgerufen, nicht „Place Autocomplete“ (New). Widget-Aufrufe 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 und nicht im Places SDK for Android (New) verfügbar.
Verbesserungen im Places SDK for Android (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die dem Places SDK for Android (neu) hinzugefügt wurden.
Auf der Google Cloud-Standardplattform implementiert
Das Places SDK for Android (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung sorgt für eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein gewisses Maß an Konsistenz zwischen den SDKs. Dadurch wird die Effizienz der Entwicklung mit dem Places SDK for Android (neu) verbessert.
Verbesserte Leistung
Das Places SDK for Android (New) bietet eine verbesserte Leistung, weshalb es sich lohnt, Apps zu ersetzen, in denen das vorhandene SDK verwendet wird.
Neue Funktionen
Das Places SDK for Android (New) enthält die aktuellen Versionen aller SDK-Funktionen:
- Automatische Vervollständigung (neu)
- Place Details (neu)
- Nearby Search (neu)
- Fotos von Orten (neu)
- Text Search (Neu)
Neuer „Text Search“-Dienst
Die Funktion Text Search (New) gibt auf Grundlage eines Strings Informationen zu verschiedenen Orten zurück, z. B. „Pizza in New York“, „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 ggf. der festgelegten Standortgewichtung entsprechen.
Neue Antwortdaten in Placed Details (New) und Place Photos (New) hinzugefügt
Place Details (New) enthält jetzt die neue Review-Klasse im
Place-Antwortobjekt. Die Klasse Place enthält die neue MethodegetReviews(), die dieses Feld unterstützt. Rufen SiegetReviews()auf, um bis zu fünf Rezensionen für einen Ort zurückzugeben.Mit Place Photo (Neu) wird
AuthorAttributionszurPhotoMetadata-Klasse hinzugefügt.AuthorAttributionsenthält einListmitAuthorAttribution-Objekten.
Neue URI-Antwort zu Place Photos hinzugefügt (neu)
Sie können jetzt Place Photo (New) verwenden, um einen URI zu einer Bild-Bitmap zurückzugeben. Bisher konnte nur die Bild-Bitmap selbst zurückgegeben werden.
Vereinfachte Preisgestaltung
Die Preisgestaltung für das Places SDK for Android (New) ist vereinfacht, sodass Sie nur für die Daten zahlen, die Sie tatsächlich nutzen. Die vereinfachte Preisgestaltung wird durch Feldlisten, auch Feldmasken genannt, implementiert.
Bei „Place Details“ und „Text Search“ verwenden Sie Feldlisten, um die Liste der Felder zu steuern, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Die Verwendung einer Feldliste ist eine bewährte Methode, um sicherzustellen, dass Sie keine unnötigen Daten anfordern, wodurch unnötige Verarbeitungszeiten und Gebühren vermieden werden können.
Ausführliche Preisinformationen für beide SDKs findest du unter Nutzung und Abrechnung.
Erweiterte Ortstypen
Im neuen SDK werden die Ortstypen hinzugefügt, die in der folgenden Tabelle aufgeführt sind. Diese Typen werden als Teil der „Place Details“- und „Text Search“-Antworten zurückgegeben. Sie können diese neuen 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 | Schneidern |
| 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 |
Zusammen mit diesen neuen Typen wurden in der Places API (New) die folgenden Typen aus Tabelle 2 für die Places API in Tabelle A für die Places API (New) verschoben. Das bedeutet, dass Sie diese Typen jetzt als Teil einer Suche verwenden können:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality