API-Version auswählen

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:

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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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:

  1. Wenn Sie Neukunde sind und gerade erst mit der Places API loslegen, und beginnen Sie mit den neuen APIs.

  2. 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.

  3. 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.