Migration – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Leitfaden werden die wichtigsten Unterschiede zwischen dem alten Places Service und der neuen Place-Klasse beschrieben. Ein Upgrade auf die Place-Klasse bietet erhebliche Vorteile, darunter eine verbesserte Leistung und ein neues Preismodell. Damit Sie die Places API optimal nutzen und Ihre Apps auf dem neuesten Stand halten können, sollten Sie sich mit den in diesem Leitfaden beschriebenen Änderungen vertraut machen.

Best Practices für die Abrechnung bei der Migration

Diese Anleitung gilt, wenn Ihre API-Nutzung hoch genug ist, um in die Preisstufe 2 zu fallen. Bei der Migration zu einer neueren Version einer API wird Ihnen auch eine andere SKU in Rechnung gestellt. Um erhöhte Kosten im Monat der Umstellung zu vermeiden, empfehlen wir, so bald wie möglich im Monat auf die neuen APIs umzustellen. So erreichen Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen. Informationen zu den Preismodellen finden Sie auf der Preisseite und in den häufig gestellten Fragen zu den Preisen.

Places API aktivieren

Die Place-Klasse basiert auf dem Places API-Dienst. Wenn Sie die Funktionen der neuen Place-Klasse verwenden möchten, müssen Sie zuerst die Places API (New) in Ihrem Google Cloud-Projekt aktivieren. Weitere Informationen finden Sie unter Erste Schritte.

Allgemeine Änderungen

In der folgenden Tabelle sind einige der wichtigsten Unterschiede zwischen PlacesService und Place aufgeführt:

PlacesService (alt) Place (Neu)
Für Methoden ist die Verwendung eines Callbacks erforderlich, um das Ergebnisobjekt und die google.maps.places.PlacesServiceStatus-Antwort zu verarbeiten. Verwendet Promises und funktioniert asynchron.
Für Methoden ist eine PlacesServiceStatus-Prüfung erforderlich. Keine Statusprüfung erforderlich, es kann die Standardfehlerbehandlung verwendet werden.
Ortsdatenfelder werden im Snake Case-Format formatiert. Ortsdatenfelder werden im CamelCase-Format formatiert.
Beschränkt auf eine feste Gruppe von Ortsarten und Ortsdatenfeldern. Bietet eine erweiterte Auswahl an regelmäßig aktualisierten Ortsarten und Ortsdatenfeldern.

API-spezifische Änderungen

Die Place-Klasse bietet eine API zum Verwenden der Places Library und unterstützt moderne Nutzungsmuster wie Promises. Die Place-Klasse macht dieselben Felder für Ortsdaten und Ortstypen wie der alte Places-Dienst verfügbar und enthält viele neue Werte für Felder für Ortsdaten und Ortstypen.

In dieser Tabelle sehen Sie, wie die Funktionen des Places Service den Funktionen der Place-Klasse zugeordnet werden:

Places Service (Legacy) Place Class (New)
Ortsdatenfelder Datenfelder der „Place“-Klasse
Ortstypen Ortstypen
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete-Klasse PlaceAutocompleteElement-Klasse
SearchBox-Klasse ---

Places Library laden

Wie die Places-Bibliothek in Ihrer App geladen wird, hängt davon ab, welcher Bootstrap-Loader verwendet wird. Wenn Ihre App Dynamic Library Import verwendet, können Sie die erforderlichen Bibliotheken zur Laufzeit laden, indem Sie den Operator await verwenden, um importLibrary() aufzurufen, wie hier gezeigt:

const { Place } = await google.maps.importLibrary("places");

Wenn in Ihrer App das Tag zum direkten Laden von Scripts verwendet wird, fordern Sie die places-Bibliothek im Ladescript an:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

Weitere Informationen zum Laden der Maps JavaScript API

Dieser Abschnitt enthält die folgenden Anleitungen, die Ihnen bei der Migration Ihrer Apps zur Verwendung der neuesten Version der Places API helfen: