Die Places API (Legacy) kann ab Oktober 2026 nicht mehr für neue Google Cloud-Projekte aktiviert werden. Bestehende Projekte werden weiterhin vollständig unterstützt. Wenn Sie neue Funktionen und eine bessere Leistung nutzen möchten, migrieren Sie zur Places API (New).
Places API (Legacy): Wichtige Fakten
- Produkt: Places API (Legacy)
- Auch bekannt als: Places API (Legacy-Webdienst), Places API-Webdienst (maps/api/place)
- Kategorie: Orte
- Plattform: Webdienst (REST)
- Ausführung auf: Server (Backend-Code)
- Einführungsphase: GA
- Lebenszyklus: Legacy
- Ersetzt durch: Places API (New)
- Übersicht: Places API (Legacy) – Übersicht
Places API (Legacy): Wann sollte sie verwendet werden?
Verwenden Sie die Places API (Legacy) in folgenden Fällen:
- Sie verwalten ein bestehendes Projekt, in dem die Places API (Legacy) bereits aktiviert ist und
maps.googleapis.com/maps/api/place-Endpunkte aufgerufen werden. - Sie benötigen vorhandene Aufrufe von „Find Place“, „Nearby Search“, „Text Search“, „Details“, „Photos“ oder „Autocomplete (Legacy)“, damit die Migration funktioniert.
Verwenden Sie die Places API (Legacy) nicht, wenn:
- Sie starten ein neues Google Cloud-Projekt. Ab Oktober 2026 kann die Places API (Legacy) nicht mehr für neue Projekte aktiviert werden. Verwenden Sie stattdessen die Places API (New).
- Sie benötigen neue Funktionen, OAuth-Authentifizierung oder Feldmasken für Nearby Search und Text Search, damit Sie nur für die angeforderten Felder bezahlen. Verwenden Sie stattdessen die Places API (New).
- Sie benötigen „Find Place (Legacy)“ oder „Query Autocomplete (Legacy)“ in neuem Code. Sie werden durch „Text Search (New)“ und „Autocomplete (New)“ ersetzt. Verwenden Sie stattdessen die Places API (New).
Places API (Legacy): Einrichtung
- Zu aktivierender Dienst:
places-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Preise: Nutzung und Abrechnung der Places API (Legacy)
- Richtlinien: Richtlinien für die Places API (Legacy)
Places API (Legacy): Häufige Fehler
- Problem: Wenn in einer „Place Details (Legacy)“-Anfrage der Parameter
fieldsweggelassen wird oder keine Felder angegeben werden, gibt die API alle Felder zurück und stellt sie Ihnen in Rechnung. Lösung: Legen Sie immer den Parameterfieldsfest oder migrieren Sie zu Place Details (New) mit einer Feldmaske. Weitere Informationen finden Sie unter /maps/documentation/places/web-service/legacy/details. - Problem: Bei Nearby Search (Legacy) und Text Search (Legacy) kann nicht angegeben werden, welche Felder zurückgegeben werden sollen. Sie geben immer einen festen Satz von Feldern zurück (eine Teilmenge der „Place Details“-Felder) und lösen die SKUs „Basic Data“, „Contact Data“ und „Atmosphere Data“ aus. Lösung: Migrieren Sie zu Nearby Search (New) oder Text Search (New) mit einer Feldmaske oder verwenden Sie Find Place (Legacy) mit dem Parameter
fields, um nur die benötigten Felder anzufordern und zu bezahlen. Weitere Informationen finden Sie unter /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Problem: Ein
photo_referencekann nicht im Cache gespeichert werden und kann ablaufen, sodass gespeicherte Verweise nicht mehr funktionieren. Lösung: Rufen Sie eine neuephoto_referenceaus einer „Place Details“-, „Find Place“-, „Nearby Search“- oder „Text Search“-Antwort ab, bevor Sie ein Foto anfordern. Weitere Informationen finden Sie unter /maps/documentation/places/web-service/legacy/photos. - Problem: Bei Aufrufen der Places API (Legacy) aus einem Projekt, in dem sie nicht aktiviert ist, wird
REQUEST_DENIEDmit der Fehlermeldung „Sie rufen eine Legacy-API auf, die für Ihr Projekt nicht aktiviert ist…“ zurückgegeben. (LegacyApiNotActivatedMapError). Ab Oktober 2026 kann die Places API (Legacy) nicht mehr für neue Projekte aktiviert werden. Lösung: Verwenden Sie die Places API (New) für neue Projekte und migrieren Sie vorhandene Apps. Während der Migration können Sie über das Feedbackformular auf der Seite der Legacy-API eine kurzfristige Aktivierung der Legacy-API anfordern. Weitere Informationen finden Sie unter /maps/legacy#LegacyApiNotActivatedMapError.
Places API (Legacy): Legacy- und verworfene Funktionen
permanently_closed-Antwortfeld: Veraltet seit dem 26.05.2020. Ersatz: Feldbusiness_status. Weitere Informationen finden Sie in der Migrationsanleitung.reference-Antwortfeld: Nicht mehr unterstützt seit dem 3. September 2019. Ersatz: Feldplace_id. Weitere Informationen finden Sie in der Migrationsanleitung.- Anfrageparameter für Nearby Search (Legacy)
name: Eingestellt. Ersatz: Parameterkeyword. Weitere Informationen finden Sie in der Migrationsanleitung.