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. Das gilt sowohl für neue als auch für bestehende Kunden, die die APIs bereits nutzen. In diesem Leitfaden erfahren Sie, welche Unterschiede zwischen den beiden APIs bestehen.
Liste der APIs
In der folgenden Tabelle sind beide API-Sätze aufgeführt. Wenn Sie bereits Kunde sind, können Sie anhand dieser Tabelle die neue API ermitteln, die eine von Ihnen 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: 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 im Abschnitt 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, lesen Sie die folgenden Migrationsanleitungen für die einzelnen APIs:
- Zu Nearby Search (neu) migrieren
- Zu Text Search (neu) migrieren
- Zu „Place Details (New)“ migrieren
- 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 (New) 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 Einheitlichkeit zwischen den APIs und erhöht die Entwicklungseffizienz mit der Places API (New).
Verbesserte Leistung
Die Places API (neu) bietet eine verbesserte Leistung. Daher lohnt es sich, Apps zu ersetzen, die die vorhandene Places API verwenden.
Transparente Kosten
Die Preise für die Places API (neu) sind vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie verwenden. Die transparente Preisgestaltung wird 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 Feldmaskierung ist eine gute Designpraxis, um sicherzustellen, dass keine unnötigen Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Abrechnungskosten 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. Mit der Places API (neu) wird die Antwort standardisiert, sodass diese APIs für einen Ort jeweils dieselben Daten zurückgeben.
Erweiterte Ortstypen
Die API-Antwort kann jetzt den primären Typ eines Orts enthalten. Jeder Ort kann einen einzelnen Typ haben, der als primärer Typ des Orts festgelegt 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 | Bauernhofurlaub | 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 | Heliport | 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 dynamische Nutzerinteraktionen erstellen.
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.