Die Places API unterstützt zwei API-Versionen: Die Places API sind die vorhandenen APIs und die Places API (New) ist die Version der nächsten Generation.
Mit der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs verwendet werden sollen. Dies gilt, wenn Sie Neukunde oder Bestandskunde sind und die APIs bereits verwenden. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs erläutert.
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 | Textsuche (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 und einer Textabfrage sollte Text Search (New) verwendet werden, da „Nearby Search (New)“ keine Texteingabe unterstützt. |
| Textsuche | Textsuche (neu) | |
| Ortsdetails | Place Details (neu) | |
| Ortsfoto | Ortsfoto (neu) | |
| Place Autocomplete | Automatische Vervollständigung (neu) | |
| Automatische Vervollständigung von Abfragen | Automatische Vervollständigung (neu) | Funktionen zur automatischen Vervollständigung (neu) |
Die Version des Places API-Dienstes, die Sie für Ihren API-Schlüssel aktivieren, steuert, welche APIs von Ihrer App verwendet werden:
Places API: Aktiviert die vorhandenen APIs. Wenn nur die Places API für das Projekt aktiviert ist, das mit dem für Ihre App verwendeten API-Schlüssel verknüpft ist, hat Ihre App keinen Zugriff auf die neuen APIs.
Places API (New): Alle neuen APIs und Funktionen werden aktiviert, die unter Wichtige Funktionen, die dem Places SDK for iOS (neu) hinzugefügt wurden beschrieben werden. Ihre Anwendung hat dann keinen Zugriff auf die vorhandenen APIs.
Beides: Alle Funktionen und APIs werden sowohl für das Places SDK for iOS (New) als auch das Places SDK for iOS aktiviert.
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 Migrationsanleitungen für die einzelnen APIs:
- Zu Nearby Search migrieren (neu)
- Zu „Text Search“ migrieren (neu)
- Zu Place Details migrieren (Neu)
- Zu Place Photo migrieren (neu)
- Zur automatischen Vervollständigung migrieren (neu)
Wichtige Funktionen der Places API (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die der Places API (New) hinzugefügt wurden.
Implementierung auf der Google Cloud-Standardplattform
Die Places API (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung sorgt für eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses API-Standarddesign sorgt für ein gewisses Maß an Konsistenz über alle APIs hinweg, was die Effizienz der Entwicklung mit der Places API (New) verbessert.
Verbesserte Leistung
Die Leistung der Places API (New) wurde verbessert. Daher lohnt es sich, Apps zu ersetzen, die die vorhandene Places API verwenden.
Vereinfachte Preisgestaltung
Die Preisgestaltung wurde mit der Places API (New) vereinfacht, sodass Sie nur für die Daten zahlen, die Sie tatsächlich nutzen. Vereinfachte Preise werden mithilfe einer Feldmaske implementiert.
Bei „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ können Sie mit der Feldmaske die Liste der Felder 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 zu verhindern, dass unnötige Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Einheitliche Antwortdaten für einen Ort
Die „Place Details“-, „Nearby Search“- und „Text Search“-APIs haben bei den vorhandenen APIs unterschiedliche Antwortdaten für einen Ort zurückgegeben. Die Places API (New) standardisiert die Antwort, sodass alle APIs dieselben Daten für einen Ort zurückgeben.
Maximierte Ortstypen
Die API-Antwort kann jetzt den primären Typ eines Ortes enthalten. Jeder Ort kann einen einzigen Typwert haben, der als primärer Typ des Orts angegeben ist (siehe Tabelle A).
Außerdem wurden in der neuen API die in der folgenden Tabelle aufgeführten Ortstypen hinzugefügt. 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 | 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
Dynamische Ortsdaten
Die Places API (New) unterstützt dynamische Antwortdaten, z. B. die Verfügbarkeit von Ladestationen für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise einer Tankstelle. Verwenden Sie diese Antwortfelder, um dynamische Nutzererfahrungen zu erstellen.
Welche API wählen Sie aus?
Bevor Sie mit der App-Entwicklung beginnen können, müssen Sie Ihre API auswählen:
Wenn Sie Neukunde sind und die Places API noch nicht kennen, verwenden Sie die neuen APIs.
Wenn Sie Neukunde sind und noch keinen Ersatz 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 verbesserten Funktionen der Places API (New) profitieren möchten, können Sie zu den neuen APIs migrieren.
Weitere Informationen zur Migration finden Sie unter Migration – Übersicht.