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 (neu) müssen Sie zuerst entscheiden, welche APIs Sie verwenden möchten. 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) | 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: 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 (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.
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 (neu) migrieren
- Zu „Text Search“ migrieren (neu)
- 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.
Implementierung auf der Google Cloud-Standardplattform
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 erhöht so die Entwicklungseffizienz mit der Places API (New).
Verbesserte Leistung
Die Leistung der Places API (New) wurde verbessert. 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 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. 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 für einen Ort immer dieselben Daten 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 eine dynamische Nutzererfahrung schaffen.
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 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.