Die Places API unterstützt zwei API-Versionen: Die Places API ist die vorhandenen APIs und Places API (New) ist die Version der nächsten Generation.
Bei der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs verwendet werden sollen. Dies gilt für Neu- oder Bestandskund*innen, die die APIs bereits verwenden. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs beschrieben.
Liste der APIs
In der folgenden Tabelle sind beide API-Sätze aufgeführt. Wenn Sie Bestandskunde sind, können Sie anhand dieser Tabelle die neue API ermitteln, die eine aktuell verwendete API ersetzt.
Places API | Places API (New) | Hinweise |
---|---|---|
Find Place | Text Search (Neu) | Es gibt keine neue Version von Find Place. Sie wurde durch Text Search (New) ersetzt. |
Nearby Search | Nearby Search (neu) | Für alle Anfragen mit der vorhandenen API, die eine Textabfrage enthalten, sollte Text Search (New) verwendet werden, da „Nearby Search (New)“ keine Texteingabe unterstützt. |
Textsuche | Text Search (Neu) | |
Ortsdetails | Place Details (neu) | |
Foto des Ortes | Foto des Ortes (Neu) | |
Place Autocomplete | Automatische Vervollständigung (neu) | In der Vorschau |
Query Autocomplete | Automatische Vervollständigung (neu) | Funktionen der Vorschauversion der automatischen Vervollständigung hinzugefügt (neu) |
Mit der Version des Places API-Dienstes, den Sie für Ihren API-Schlüssel aktivieren, werden die von Ihrer App verwendeten APIs gesteuert:
Places API: Aktiviert die vorhandenen APIs. Wenn nur die Places API für das Projekt aktiviert ist, das mit dem API-Schlüssel verknüpft ist, der für Ihre App verwendet wird, hat Ihre App keinen Zugriff auf die neuen APIs.
Places API (New): Aktiviert alle neuen APIs und Funktionen, die unter Wichtige Funktionen des Places SDK for iOS (neu) beschrieben werden. Ihre Anwendung hat dann keinen Zugriff auf die vorhandenen APIs.
Beide: Aktiviert alle Funktionen und APIs für das Places SDK for iOS (New) und das Places SDK for iOS.
Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.
Zu den neuen APIs migrieren
Wenn Sie eine vorhandene API verwenden und zur neuen API migrieren möchten, lesen Sie die folgenden Migrationsleitfäden für jede API:
- Zu Nearby Search migrieren (neu)
- Zu Text Search migrieren (neu)
- Migration zu Place Details (neu)
- Migration zu Place Photo (Neu)
- Zur automatischen Vervollständigung migrieren (neu)
Wichtige Funktionen der Places API (neu)
In diesem Abschnitt werden die wichtigsten Funktionen der Places API (neu) beschrieben.
Auf der Google Cloud-Standardplattform implementiert
Die Places API (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung ermöglicht eine sicherere und vertrauenswürdige Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses Standard-API-Design sorgt für ein Maß an Konsistenz zwischen den APIs, wodurch die Entwicklung mit der Places API (New) effizienter wird.
Verbesserte Leistung
Durch die verbesserte Leistung der „Places API (New)“ lohnt es sich, Anwendungen zu ersetzen, für die die vorhandene Places API verwendet wird.
Vereinfachte Preisgestaltung
Die Preisgestaltung wird mit der Places API (New) vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie tatsächlich nutzen. Die vereinfachte Preisgestaltung wird mithilfe einer Feldmaske implementiert.
Bei „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ verwenden Sie die Feldmaske, 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 Maskierung von Feldern hat sich bewährt, um das Anfordern unnötiger Daten zu vermeiden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Einheitliche Antwortdaten für einen Ort
Bei den vorhandenen APIs haben die „Place Details“-, „Nearby Search“- und „Text Search“-APIs unterschiedliche Antwortdaten für einen Ort zurückgegeben. „Places API (New)“ standardisiert die Antwort, sodass diese APIs alle dieselben Daten für einen Ort zurückgeben.
Erweiterte Ortstypen
Die API-Antwort kann jetzt den primären Typ eines Ortes enthalten. Jeder Ort kann einen einzelnen Typwert haben, der als primärer Typ des Ortes angegeben ist, wie in Tabelle A aufgeführt.
Außerdem werden mit der neuen API die Ortstypen hinzugefügt, die in der folgenden Tabelle aufgeführt sind. Sie können diese neuen und die vorhandenen Typen in einer Suche mit Nearby Search (New) und Text Search (New) verwenden. Die neuen Typen sind alle 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
Dynamische Ortsdaten
Die Places API (New) unterstützt dynamische Antwortdaten, z. B. die Verfügbarkeit einer Ladestation für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise für eine Tankstelle. Verwenden Sie diese Antwortfelder, um dynamische User Experiences zu erstellen.
Für welche API entscheiden Sie sich?
Bevor Sie mit der Anwendungsentwicklung beginnen können, müssen Sie Ihre API auswählen:
Wenn Sie Neukunde sind und die Places API erst seit Kurzem nutzen, sollten Sie mit den neuen APIs beginnen.
Wenn Sie Neukunde sind und noch keine Alternative für eine vorhandene API wie Place Autocomplete oder Query Autocomplete haben, können Sie eine Kombination aus neuen und vorhandenen APIs verwenden.
Wenn Sie Bestandskunde sind, können Sie die vorhandenen APIs weiterhin verwenden. Wenn Sie jedoch von den Leistungsverbesserungen und den Funktionsverbesserungen der Places API (New) profitieren möchten, können Sie zu den neuen APIs migrieren.
Weitere Informationen zur Migration finden Sie unter Migrationsübersicht.