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
- Zu aktivierender Dienst:
places.googleapis.com - Authentifizierung: API-Schlüssel, OAuth 2.0
- Erste Schritte: Places API (New) einrichten
- Referenz: Places API (New) – Referenz
- Preise: Nutzung und Abrechnung der Places API (New)
- Richtlinien: Richtlinien für die Places API (New)
- Versionshinweise: Versionshinweise zur Places API (New)
Offizielle Places API (New)-Pakete:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (New): ähnliche Produkte
- Ersetzt: Places API (Legacy)
- Häufig verwendet mit: Geocoding API, Routes API, Address Validation API
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
fieldsoder$fieldsoder dem HeaderX-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
PlacesServicein einem Projekt aufruft, in dem die Legacy API nicht aktiviert ist, schlägt mitLegacyApiNotActivatedMapErrorfehl. 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 400INVALID_ARGUMENTzurückgegeben. Lösung: Aktualisieren Sie gespeicherte Orts-IDs, die älter als 12 Monate sind, mit einer „Place Details (New)“-Anfrage, in der nur das Feldidangegeben 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
- Gibt eine KI-gestützte Zusammenfassung der Nutzerrezensionen für eine bestimmte Google Place-ID zurück.
- Eine KI-basierte Zusammenfassung der Umgebung und der Ausstattung einer bestimmten Google-Orts-ID für eine Ladestation für Elektrofahrzeuge zurückgeben.
Places API (New): Places
- Eine Liste von Orten und Ortsdetails basierend auf einem Abfragestring zurückgeben
- Eine Liste von Orten und Ortsdetails in der Nähe eines bestimmten Standorts zurückgeben
- Automatische Vervollständigung von Orten auf Grundlage eines Abfragestrings
- Detaillierte Informationen zu einem bestimmten Ort zurückgeben
- Fotos eines bestimmten Ortes zurückgeben Hinweis: Zeigen Sie die Autorenangaben (Name des Autors, verknüpft mit seinem Profil-URI) zusammen mit dem Foto an. Dies ist in den Places-Richtlinien für die einzelnen Plattformen vorgeschrieben, z. B. unter /maps/documentation/javascript/policies#photo-attributions und /maps/documentation/places/web-service/policies#photos-and-review.
- Größe von Fotos eines Ortes anpassen
- Bewertungen und Rezensionen für einen bestimmten Ort zurückgeben Hinweis: Im Places API (New) Webdienst ist „Place Details“ eine HTTP-GET-Anfrage an https://places.googleapis.com/v1/places/{placeId} mit X-Goog-FieldMask (z. B. rating,userRatingCount,reviews). Für „Text Search“, „Nearby Search“ und „Autocomplete“ wird POST verwendet. Übergeben Sie unter Android „Place.Field.RATING“, „USER_RATING_COUNT“ und „REVIEWS“ an „PlacesClient.fetchPlace()“. Übergeben Sie unter iOS „GMSPlacePropertyRating“, „GMSPlacePropertyUserRatingsTotal“ und „GMSPlacePropertyReviews“ in „GMSFetchPlaceRequest“.
- Datenfelder angeben, die in Antworten mit Ortsinformationen enthalten sein sollen
- Geben Sie die Ortstypen an, die in Antworten auf Anfragen zu Ortsinformationen enthalten sein sollen.
- Den URI zurückgeben, um die Seite mit den Ortsdetails in Google Maps für einen Ort zu öffnen.
- URI zurückgeben, um die Seite mit der Wegbeschreibung in Google Maps für einen Ort zu öffnen
- Gibt den URI zurück, um die Seite zum Schreiben einer Rezension für einen Ort in Google Maps zu öffnen.
- URI zurückgeben, um die Seite mit den Rezensionen für einen Ort in Google Maps zu öffnen
- URI zum Öffnen der Fotoseite für einen Ort in Google Maps zurückgeben
- Eine KI-basierte Übersicht für einen bestimmten Ort zurückgeben
- Eine KI-basierte Zusammenfassung der Umgebung eines bestimmten Ortes zurückgeben
- Informationen zu Orten entlang einer vordefinierten Route anhand eines Abfragestrings zurückgeben
- Entfernung, Fahrtzeit und Wegbeschreibungs-URI für Orte zurückgeben, die per Text Search anhand von Breiten- und Längengradkoordinaten gefunden wurden
- Entfernung, Fahrtzeit und Wegbeschreibungs-URI zu Orten in der Nähe anhand von Breiten- und Längengradkoordinaten zurückgeben
- Entfernung, Reisedauer und Wegbeschreibungs-URI zwischen dem Startpunkt einer vordefinierten Route und den einzelnen Orten, die anhand eines Abfragestrings zurückgegeben werden und sich ebenfalls auf der Route befinden, zurückgeben.
- Entfernung, Reisedauer und Routen-URI zwischen den einzelnen Orten, die auf Grundlage eines Abfragestrings zurückgegeben werden und sich auch auf einer vordefinierten Route befinden, und dem Ziel der Route zurückgeben.