Übersicht über die Migration

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Leitfaden werden die wichtigsten Unterschiede zwischen dem alten Places Service und der neuen Place-Klasse hervorgehoben. Ein Upgrade auf die Ortsklasse bietet erhebliche Vorteile, darunter eine verbesserte Leistung und ein neues Preismodell. Damit Sie die Places-Funktionen optimal nutzen und Ihre Apps auf dem neuesten Stand sind, 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 zweite Preisstufe zu fallen. Wenn Sie zu einer neueren Version einer API migrieren, wird Ihnen auch eine andere SKU in Rechnung gestellt. Um erhöhte Kosten im Monat der Umstellung zu vermeiden, empfehlen wir, so früh wie möglich im Monat auf die neuen APIs umzustellen. So erreichen Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen. Informationen zu Preisstufen finden Sie auf der Seite „Preise“ und in den FAQs zu 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 (Legacy) 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 Ortstypen und Ortsdatenfeldern.

API-spezifische Änderungen

Die Place-Klasse bietet eine API für die Verwendung 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 Ihre App die Places-Bibliothek lädt, 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 Ihre App das Tag zum direkten Laden von Scripts verwendet, 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 Leitfäden, die Ihnen bei der Migration Ihrer Apps zur Verwendung der neuesten Version der Places API helfen: