API-Version auswählen

Die Places API unterstützt zwei API-Versionen: Die Places API ist die vorhandenen APIs und Places API (New) ist die Version der nächsten Generation.

Bei der Veröffentlichung der Places API (New) müssen Sie zuerst entscheiden, welche APIs verwendet werden sollen. Dies gilt für Neu- oder Bestandskund*innen, die die APIs bereits verwenden. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs beschrieben.

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) Hinweise
Find Place Text Search (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 Text Search (New) verwendet werden, da „Nearby Search (New)“ keine Texteingabe unterstützt.
Textsuche Text Search (Neu)
Ortsdetails Place Details (neu)
Foto des Ortes Foto des Ortes (Neu)
Place Autocomplete Automatische Vervollständigung (neu) In der Vorschau
Query Autocomplete Automatische Vervollständigung (neu) Funktionen der Vorschauversion der automatischen Vervollständigung hinzugefügt (neu)

Mit der Version des Places API-Dienstes, den Sie für Ihren API-Schlüssel aktivieren, werden die von Ihrer App verwendeten APIs gesteuert:

  • Places API: Aktiviert die vorhandenen APIs. 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 (New): Aktiviert alle neuen APIs und Funktionen, die unter Wichtige Funktionen des Places SDK for iOS (neu) beschrieben werden. Ihre Anwendung hat dann keinen Zugriff auf die vorhandenen APIs.

  • Beide: Aktiviert alle Funktionen und APIs für das Places SDK for iOS (New) und das Places SDK for iOS.

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 Migrationsleitfäden für jede API:

Wichtige Funktionen der Places API (neu)

In diesem Abschnitt werden die wichtigsten Funktionen der Places API (neu) beschrieben.

Auf der Google Cloud-Standardplattform implementiert

Die Places API (New) ist in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung ermöglicht eine sicherere und vertrauenswürdige Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses Standard-API-Design sorgt für ein Maß an Konsistenz zwischen den APIs, wodurch die Entwicklung mit der Places API (New) effizienter wird.

Verbesserte Leistung

Durch die verbesserte Leistung der „Places API (New)“ lohnt es sich, Anwendungen zu ersetzen, für die die vorhandene Places API verwendet wird.

Vereinfachte Preisgestaltung

Die Preisgestaltung wird mit der Places API (New) vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie tatsächlich nutzen. Die vereinfachte Preisgestaltung wird mithilfe einer Feldmaske implementiert.

Bei „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ verwenden Sie die Feldmaske, um die Liste der Felder zu steuern, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Die Maskierung von Feldern hat sich bewährt, um das Anfordern unnötiger Daten zu vermeiden. So lassen sich unnötige Verarbeitungszeiten und Gebühren 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. „Places API (New)“ 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 Ortes enthalten. Jeder Ort kann einen einzelnen Typwert haben, der als primärer Typ des Ortes angegeben ist, wie in Tabelle A aufgeführt.

Außerdem werden mit der neuen API die Ortstypen hinzugefügt, die in der folgenden Tabelle aufgeführt sind. Sie können diese neuen und die vorhandenen Typen in einer Suche mit Nearby Search (New) und Text Search (New) 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 farm 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 Schneidern
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 hat die Places API (New) die folgenden Typen aus Tabelle B aus Tabelle A verschoben. Das bedeutet, dass Sie jetzt diese Typen als Teil einer Suche verwenden können:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Dynamische Ortsdaten

Die Places API (New) unterstützt dynamische Antwortdaten, z. B. die Verfügbarkeit einer Ladestation für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise für eine Tankstelle. Verwenden Sie diese Antwortfelder, um dynamische User Experiences zu erstellen.

Für welche API entscheiden Sie sich?

Bevor Sie mit der Anwendungsentwicklung beginnen können, müssen Sie Ihre API auswählen:

  1. Wenn Sie Neukunde sind und die Places API erst seit Kurzem nutzen, sollten Sie mit den neuen APIs beginnen.

  2. Wenn Sie Neukunde sind und noch keine Alternative für eine vorhandene API wie Place Autocomplete oder Query Autocomplete haben, können Sie eine Kombination aus neuen und vorhandenen APIs verwenden.

  3. Wenn Sie Bestandskunde sind, können Sie die vorhandenen APIs weiterhin verwenden. Wenn Sie jedoch von den Leistungsverbesserungen und den Funktionsverbesserungen der Places API (New) profitieren möchten, können Sie zu den neuen APIs migrieren.

    Weitere Informationen zur Migration finden Sie unter Migrationsübersicht.