Die Places API unterstützt zwei API-Versionen: Places API sind die Vorhandene APIs und Places API (New) sind die nächsten Generationsversion der APIs.
Mit der Veröffentlichung des Places API (New) müssen Sie als Erstes entscheiden, die zu verwendenden APIs. Dies gilt, wenn Sie Neukunde oder Bestandskunde sind die APIs bereits nutzen. In diesem Leitfaden werden die wichtigsten die Unterschiede zwischen den beiden APIs.
Liste der APIs
In der folgenden Tabelle sind beide API-Sätze aufgeführt. Wenn Sie Bestandskunde sind, Ermitteln Sie anhand dieser Tabelle die neue API, die eine von Ihnen genutzte API ersetzt. derzeit verwendet wird.
| Places API | Places API (New) | Hinweis |
|---|---|---|
| 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, die eine Textabfrage enthalten, sollte Folgendes verwendet werden: Textsuche (neu) da „Nearby Search (New)“ die Texteingabe nicht 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 aktivieren legt fest, welche APIs von Ihrer App verwendet werden:
Places API: Aktiviert die vorhandenen APIs. Wenn nur Places API ist für das Projekt aktiviert, das verknüpft ist mit API-Schlüssel für Ihre App verwenden, hat Ihre App keinen Zugriff auf die neuen APIs.
Places API (New): aktiviert alle neuen APIs und die unter Wichtige Funktionen, die zu Places SDK for iOS (neu) Ihre App wird nicht Zugriff auf die vorhandenen APIs haben.
Beides: Alle Funktionen und APIs werden für beides aktiviert. Places SDK for iOS (New) und Places SDK for iOS
Weitere Informationen zur Auswahl des Places API-Dienstes Siehe Google Cloud-Projekt einrichten.
Zu den neuen APIs migrieren
Wenn Sie eine vorhandene API verwenden und zur neuen API migrieren möchten, lesen Sie den Abschnitt folgende 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
Places API (New) wurde implementiert auf der Dienstinfrastruktur in Google Cloud. Diese Implementierung bringt eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Diese Standard-API Das Design sorgt für Einheitlichkeit zwischen den APIs und verbessert so die Effizienz. der Entwicklung mit Places API (New) abgeschlossen.
Verbesserte Leistung
Places API (New) bietet eine verbesserte Leistung, Daher lohnt es sich, Apps zu ersetzen, die die bestehende Places API verwenden.
Vereinfachte Preisgestaltung
Die Preisgestaltung wurde mit der Places API (New) vereinfacht, sodass Sie Sie zahlen nur für die Datennutzung. Die vereinfachte Preisgestaltung wird mithilfe eines Feldmaske.
Mit „Place Details (New)“, Nearby Search (New) und Bei „Text Search (New)“ können Sie mit der Feldmaske die Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die Daten angefordert. Die Maskierung von Feldern ist eine gute Designpraxis, um sicherzustellen, Fordern Sie keine unnötigen Daten an, um unnötige Verarbeitungszeiten zu vermeiden. und Abrechnungsgebühren.
Einheitliche Antwortdaten für einen Ort
Bei den bestehenden APIs, den Place Details, Nearby Search und Text Search APIs haben unterschiedliche Antwortdaten für einen Ort zurückgegeben. Places API (neu) 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 einzelnen Typwert, der als primärer Typ des Orts angegeben ist, wie in Tabelle A.
Außerdem wurden in der neuen API die in der folgenden Tabelle aufgeführten Ortstypen hinzugefügt. Sie können und die vorhandenen Typen in einer Suche mit Nearby Search (New) und „Text Search (New)“. Die neuen Typen sind alle in Tabelle A.
| 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 | 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 | Spielplatz | 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 im Rahmen der Places API (New) auch folgende Typen verschoben: aus Tabelle 2 für das Places API bis Tabelle A für die Places API (New). Das bedeutet, dass Sie diese Typen jetzt als Teil eines Suchen:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dynamische Ortsdaten
Places API (New) unterstützt dynamische Antwortdaten wie die Verfügbarkeit an einer Ladestation für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise einer Tankstelle. Verwenden Sie Antwortfelder, um dynamische Nutzererfahrungen zu schaffen.
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 gerade erst mit der Places API loslegen, und beginnen Sie mit den neuen APIs.
Wenn Sie Neukunde sind und noch keinen Ersatz für ein wie Place Autocomplete oder Query Autocomplete verwenden, können Sie eine Kombination aus neuen und vorhandenen APIs verwenden.
Wenn Sie Bestandskunde sind, können Sie die bestehende APIs Um jedoch von den Leistungsverbesserungen und den Funktionserweiterungen der Places API (New) hinzugefügt haben, können Sie zum neuen APIs.
Weitere Informationen zur Migration finden Sie unter Migration. Übersicht.