Die in Ihrer App verfügbaren Funktionen des Places SDK for Android sind die aus einer Kombination der SDK-Versionsnummer (z.B. 3.5.0) ermittelt wird, in Ihrer App-Konfiguration angeben, welche APIs in Ihrem API-Schlüssel aktiviert sind und wie Sie und initialisieren Sie Ihre App. In diesem Leitfaden werden die Unterschiede zwischen den Versionen und wie Sie die in Ihrer App aktivierten Versionen auswählen.
SDK-Versionsnummern
Die Versionsnummer des SDKs, das Sie in der Datei „build.gradle“ auf App-Ebene angeben. wird festgelegt, ob Ihre App Zugriff auf Funktionen hat, die in einem für eine bestimmte Veröffentlichung. „Autocomplete (New)“ ist beispielsweise nur im SDK verfügbar Version 3.5.0 oder höher.
Weitere Informationen zu den Änderungen in den einzelnen SDK-Versionen finden Sie in der Places SDK für Android-Release Notizen.
Places API-Versionen für das Places SDK for Android
Neben der SDK-Versionsnummer müssen Sie auch die Places- API-Dienst, den das SDK in der Google Cloud Console aufruft: entweder Places API oder Places API (neu). Zusammen mit der SDK-Versionsnummer auswählen, welche Version bestimmter Funktionen in Ihrer App verfügbar ist, wie „Autocomplete“ oder „Autocomplete (New)“. Sie können zwar nur ein SDK angeben, Versionsnummer angezeigt wird, können Sie sowohl die Places API als auch die Places API (New) auf Ihrem API-Schlüssel und wählen Sie dann aus, über welchen Dienst das SDK mit der Sie das SDK in Ihrer App initialisieren. In den meisten Fällen sollten Sie die Places API (New) aktivieren und die Versionen (New) des SDK-Funktionen in Ihrer App.
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 beides. Weitere Informationen finden Sie unter Aktivieren APIs
- Aktivieren Sie in den Einschränkungen für API-Schlüssel die Places API, Places API (New) oder beides. Weitere Informationen finden Sie unter API einschränken Schlüssel.
Geben Sie in der build.gradle-Datei auf App-Ebene eine Versionsnummer an. Weitere Informationen finden Sie unter Installation.
Initialisieren Sie Ihre App, indem Sie entweder die
Places.initializeWithNewPlacesApiEnabled()oderPlaces.initialize().
Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt.
SDK-Funktionen, die in den einzelnen Versionen verfügbar sind
Die folgende Tabelle zeigt, welche SDK- und API-Versionen für das jeweilige SDK erforderlich sind Funktion:
| Funktion | 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 loslegen, Beginnen Sie dann mit der Places API (New) und dem neuen SDK.
- Wenn Sie bereits Kunde sind, können Sie das vorhandene SDK weiterhin verwenden. Um jedoch von den Leistungsverbesserungen und der Funktion zu profitieren, Verbesserungen des Places SDK for Android (New) hinzugefügt haben, sollten Sie die neue SDK. Beim Wechsel zum neuen SDK ist keine Migration erforderlich. Schritte unter SDK-Version und API auswählen Dienste.
- Im Places SDK for Android (New) sind Sitzungstokens ab dem folgenden Datum verfügbar: in Version 3.5.0. Weitere Informationen finden Sie unter Sitzung Tokens
- Aufrufe über Place Autocomplete-Widgets rufen immer Place automatische Vervollständigung, nicht Place Autocomplete (New); werden Widget-Aufrufe vom Initialisierungsmethode.
- Ortsfotos (Neu) gibt nur einen URI zu einem Bitmapbild zurück, während Place Fotos gibt nur eine Bitmap zurück. Bild.
- Aktueller Ort ist nur im Places SDK for Android verfügbar, nicht im Places SDK for Android (Neu).
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 im Dienst Infrastruktur in Google Cloud. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für ein einheitliches Design der SDKs, die die Effizienz der Entwicklung mit dem Places SDK for Android (Neu).
Verbesserte Leistung
Das Places SDK for Android (New) bietet eine verbesserte Leistung, die das vorhandene SDK nutzen.
Neue Funktionen
Das Places SDK for Android (New) enthält die neuesten Versionen des gesamten 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 Informationen zurückgegeben. zu einer Reihe von Orten basierend auf einem String, z. B. „Pizza in New York“ oder „Schuhgeschäfte in der Nähe von Hamburg“ oder "Hauptstraße 123". Der Dienst antwortet mit einer Liste von Orten, die mit der Textzeichenfolge und der festgelegten Standortgewichtung übereinstimmen.
Neue Antwortdaten zu Placed Details (New) und Place Photos (neu) hinzugefügt
Ortsdetails (Neu) enthält jetzt das neue Überprüfung im
Place-Antwortobjekt. Die Place-Klasse enthält die neue MethodegetReviews()zur Unterstützung dieses Feldes. AnrufgetReviews(), um bis zu fünf Rezensionen für einen Ort zurückzugeben.Ortsfoto (Neu) fügt die Funktion
AuthorAttributionsPhotoMetadata-Klasse hinzugefügt.AuthorAttributionsenthältListvonAuthorAttributionObjekte.
Neue URI-Antwort zu Place Photos (Neu) hinzugefügt
Sie können jetzt Ortsfoto (Neu), um einen URI zu einer Bild-Bitmap zurückzugeben. Bisher konnten Sie nur das Feld Bitmap an sich.
Vereinfachte Preisgestaltung
Die Preisgestaltung wurde mit dem Places SDK for Android (New) vereinfacht, sodass Sie Sie zahlen nur für die Datennutzung. Eine vereinfachte Preisgestaltung wird mithilfe von Feldlisten, auch Feldmasken genannt.
Mit Place Details- und „Text Search“ verwenden Sie Feldlisten, um die Liste der , die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die Daten angefordert. Die Verwendung einer Feldliste ist eine gute Designpraxis, um sicherzustellen, unnötige Daten anzufordern, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.
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 sind die als Teil der Place Details- und Text Search-Antwort. Sie können diese neuen Typen auch verwenden, und die vorhandenen Typen in einer Suche mit „Text Search“. Die neuen Typen sind in der Tabelle A:
| 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 | Bauernhof | 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 | Spielplatz | 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 im Rahmen der Places API (New) auch folgende Typen verschoben: aus Tabelle 2 für das Places API bis Tabelle A für die Places API (New). Das bedeutet, dass Sie diese Typen jetzt als Teil eines Suchen:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality