Places API (New) – Kurzübersicht

Die Places API (New) ist ein Webdienst, der JSON-Standortdaten zu Einrichtungen, geografischen Standorten und POIs zurückgibt. Sie unterstützt „Text Search (New)“, „Nearby Search (New)“, „Autocomplete (New)“, „Place Details (New)“ und „Place Photos (New)“.

Places API (New): Wichtige Fakten

  • Produkt: Places API (New)
  • Auch bekannt als: Places API
  • Kategorie: Orte
  • Plattform: Webdienst (REST)
  • Ausführung auf: Server (Backend-Code)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Places API (New) – Übersicht
  • Regionale Verfügbarkeit: Weltweit. Für Projekte mit Rechnungsadressen im EWR gelten die Nutzungsbedingungen der Google Maps Platform für den EWR (gültig ab dem 8. Juli 2025). Gemäß diesen Bedingungen dürfen Places API-Inhalte, die keine Breiten- und Längengrade oder Orts-IDs sind, nur über das Places UI Kit mit einer Karte verwendet werden. KI-gestützte Orts-, Bewertungs- und Gebietszusammenfassungen sind nur in unterstützten Sprachen und Regionen verfügbar.

Places API (New): Wann sollte sie verwendet werden?

Verwenden Sie die Places API (New) in folgenden Fällen:

  • Sie müssen von einem Server aus mit einer Textabfrage (Text Search (New)) oder um einen Standort herum (Nearby Search (New)) nach Orten suchen.
  • Sie benötigen Orts- oder Suchvorschläge, die während der Eingabe von einem Backend über Autocomplete (New) abgerufen werden.
  • Sie haben eine Orts-ID und benötigen Details wie Adresse, Telefonnummer, Bewertung, Rezensionen oder Fotos.
  • Sie benötigen KI-basierte Orts-, Bewertungs- oder Gebietszusammenfassungen für einen Ort.

In folgenden Fällen sollten Sie die Places API (New) nicht verwenden:

  • Sie entwickeln eine native Android-App. Verwenden Sie stattdessen das Places SDK for Android.
  • Sie entwickeln eine native iOS-App. Verwenden Sie stattdessen das Places SDK for iOS.
  • Sie erstellen eine Browser-Webanwendung und möchten die Places Library in JavaScript laden. Verwenden Sie stattdessen die Maps JavaScript API.

Places API (New): Einrichtung

Offizielle Places API (New)-Pakete:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

Places API (New): Häufige Fehler

  • Problem: Für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ gibt es keine Standardliste mit zurückgegebenen Feldern. Anfragen ohne Feldmaske geben einen Fehler zurück. Lösung: Übergeben Sie eine Antwortfeldmaske mit dem Parameter fields oder $fields oder dem Header X-Goog-FieldMask. Weitere Informationen finden Sie unter /maps/documentation/places/web-service/choose-fields.
  • Problem: Wenn das Sitzungstoken für Autocomplete (New) weggelassen oder nach Beendigung einer Sitzung wiederverwendet wird, wird jede Anfrage separat als SKU: Autocomplete Requests abgerechnet. Lösung: Generieren Sie für jede Sitzung ein neues Sitzungstoken (UUID v4 empfohlen) und beenden Sie die Sitzung mit einer Place Details (New)- oder Address Validation-Anfrage. Weitere Informationen finden Sie unter /maps/documentation/places/web-service/place-session-tokens.
  • Problem: Vorhandener oder KI-generierter Code, der die Places API (Legacy) oder die Maps JavaScript API PlacesService in einem Projekt aufruft, in dem die Legacy API nicht aktiviert ist, schlägt mit LegacyApiNotActivatedMapError fehl. Lösung: Migrieren Sie die Aufrufe zur Places API (New) und fügen Sie die erforderliche Feldmaske hinzu. Weitere Informationen finden Sie unter /maps/legacy#LegacyApiNotActivatedMapError.
  • Problem: Gespeicherte Orts-IDs können veralten. Place Details (New) gibt dann NOT_FOUND (HTTP 404) zurück. Bei fehlerhaften oder unvollständigen IDs wird HTTP 400 INVALID_ARGUMENT zurückgegeben. Lösung: Aktualisieren Sie gespeicherte Orts-IDs, die älter als 12 Monate sind, mit einer „Place Details (New)“-Anfrage, in der nur das Feld id angegeben ist (kostenlos). Weitere Informationen finden Sie unter /maps/documentation/places/web-service/place-id#refresh-id.

Möglichkeiten mit der Places API (New)

Informationen zu den einzelnen Aufgaben finden Sie in den unten verlinkten Anleitungen. Sie können die Produkte auch im Capabilities Explorer vergleichen.

Places API (New): Generative KI

Places API (New): Places