Die Places API unterstützt zwei API-Versionen: Die Places API sind die vorhandenen APIs und die Places API (neu) sind die APIs der nächsten Generation.
Mit der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs Sie verwenden möchten. Das gilt sowohl für neue als auch für bestehende Kunden, die die APIs bereits nutzen. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs erläutert.
Liste der APIs
In der folgenden Tabelle sind beide API-Sets aufgeführt. Wenn Sie bereits Kunde sind, können Sie anhand dieser Tabelle die neue API ermitteln, die eine API ersetzt, die Sie derzeit verwenden.
| Places API | Places API (New) | Hinweis |
|---|---|---|
| Find Place | Text Search (Neu) | Es gibt keine neue Version von „Ort finden“. Sie wurde durch „Text Search (New)“ ersetzt. |
| Nearby Search | Nearby Search (Neu) | Alle Anfragen mit der vorhandenen API, die eine Textabfrage enthalten, sollten Text Search (New) verwenden, da die Nearby Search (New) keine Texteingabe unterstützt. |
| Text Search | Text Search (Neu) | |
| Place Details | Ortsdetails (neu) | |
| Ortsfoto | Ortsfoto (neu) | |
| Place Autocomplete | Automatische Vervollständigung (neu) | |
| Query Autocomplete | Automatische Vervollständigung (neu) | Dem Autocomplete-Dienst (neu) hinzugefügte Funktionen |
Die Version des Places API-Dienstes, die Sie für Ihren API-Schlüssel aktivieren, steuert die von Ihrer App verwendeten APIs:
Places API: Hiermit werden die vorhandenen APIs aktiviert. 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 (neu): Hiermit werden alle neuen APIs und Funktionen aktiviert, die unter Wichtige Funktionen, die dem Places SDK for iOS hinzugefügt wurden (neu) beschrieben sind. Ihre App hat keinen Zugriff auf die vorhandenen APIs.
Beide: Hiermit werden alle Funktionen und APIs sowohl für das Places SDK for iOS (New) als auch für 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, finden Sie in den folgenden Migrationsleitfäden Informationen zu den einzelnen APIs:
- Zu Nearby Search (neu) migrieren
- Zu Text Search (neu) migrieren
- Zu „Place Details“ migrieren (neu)
- Zu „Places Photo (New)“ migrieren
- Zu „Autocomplete“ (neu) migrieren
Wichtige Funktionen, die der Places API hinzugefügt wurden (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die der Places API (neu) hinzugefügt wurden.
Auf der Google Cloud-Standardplattform implementiert
Die Places API (neu) wird in der Dienstinfrastruktur von Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses standardmäßige API-Design sorgt für Konsistenz zwischen den APIs und verbessert die Effizienz der Entwicklung mit der Places API (New).
Verbesserte Leistung
Die Places API (New) bietet eine verbesserte Leistung. Daher lohnt es sich, Apps zu ersetzen, die die vorhandene Places API verwenden.
Transparente Kosten
Mit der Places API (neu) sind die Preise vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie verwenden. Transparente Kosten werden mithilfe einer Feldmaske implementiert.
Bei „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ können Sie mithilfe 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. Mit der Maskierung von Feldern lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.
Einheitliche Antwortdaten für einen Ort
Bei den vorhandenen APIs wurden mit den APIs „Place Details“, „Nearby Search“ und „Text Search“ unterschiedliche Antwortdaten für einen Ort zurückgegeben. Die Places API (neu) 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 Orts enthalten. Jeder Ort kann einen einzelnen Typwert haben, der als primärer Typ des Orts angegeben ist, wie in Tabelle A aufgeführt.
Außerdem werden in der neuen API die in der folgenden Tabelle aufgeführten Ortstypen hinzugefügt. Sie können diese neuen Typen und die vorhandenen Typen in einer Suche mit der Nearby Search (Neu) und der Text Search (Neu) 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 | Bauernhof | korean_restaurant | sporting_goods_store |
| barber_shop | Agrotourismus | 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 | anpassen |
| 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 in der Places API (neu) die folgenden Typen aus Tabelle 2 der Places API in Tabelle A der Places API (neu) verschoben. Sie können also jetzt folgende Typen in Suchanfragen verwenden:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dynamische Ortsdaten
Die Places API (neu) unterstützt dynamische Antwortdaten wie die Verfügbarkeit einer Ladestation für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise einer Tankstelle. Mit diesen Antwortfeldern können Sie die Nutzerfreundlichkeit verbessern.
Welche API wählen Sie aus?
Bevor Sie mit der App-Entwicklung beginnen können, müssen Sie eine API auswählen:
Wenn Sie neuer Kunde sind und gerade erst mit der Places API beginnen, sollten Sie mit den neuen APIs beginnen.
Wenn Sie Neukunde sind und es noch keinen Ersatz für eine vorhandene API gibt, z. B. die Autocomplete API für Orte oder die Autocomplete API für Suchanfragen, 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 die Leistungsverbesserungen und Funktionserweiterungen der Places API (New) nutzen möchten, können Sie zu den neuen APIs migrieren.
Weitere Informationen zur Migration finden Sie unter Migration – Übersicht.