Übersicht über die Migration

Entwickler im Europäischen Wirtschaftsraum (EWR)

Das Places SDK for Android (New) bietet eine verbesserte Leistung und ein neues Preismodell. Es lohnt sich also, Apps, in denen das Places SDK for Android (Legacy) verwendet wird, zu aktualisieren. Weitere Informationen zum Vergleichen von Funktionen finden Sie unter SDK auswählen.

In diesem Leitfaden erfahren Sie mehr über die wichtigsten Unterschiede zwischen dem Places SDK for Android (Neu) und dem Places SDK for Android (Alt) sowie darüber, wie Sie notwendige Änderungen vornehmen.

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 (New) aktivieren

Das Places SDK for Android (Legacy) basiert auf dem Dienst Places API. Wenn Sie die Funktionen des Places SDK for Android (New) verwenden möchten, müssen Sie zuerst die Places API (New) in Ihrem Google Cloud-Projekt aktivieren. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.

Sie müssen dann dafür sorgen, dass Sie die Places API (New) der Liste der autorisierten APIs für den von Ihrer App verwendeten Schlüssel hinzugefügt haben. Weitere Informationen finden Sie unter API-Schlüssel verwenden.

Prüfen, ob Sie genügend Kontingent für die Places API (New) haben

Prüfen Sie, ob in der Places API (New) genügend Kontingent für Ihren aktuellen Traffic vorhanden ist. Informationen zum Überprüfen und Verwalten Ihrer Kontingente und Nutzungslimits finden Sie unter Kontingente und Kontingentbenachrichtigungen.

Beachten Sie den Unterschied:

  • Das Kontingent für das Places SDK for Android (Legacy) basiert auf dem Kontingent des Places API-Dienstes. Sie ist die Summe aller Places API-Methoden.
  • Das Kontingent für das Places SDK for Android (New) basiert auf dem Kontingent des Dienstes „Places API (New)“. Für jede API-Methode gibt es ein separates Kontingent.

Prüfen, ob die Places API (New) in Ihrer ausgehandelten Vereinbarung enthalten ist

Wenn Sie eine Vereinbarung mit ausgehandelten Preisen haben, prüfen Sie, ob sie die Places API (New) mit den erwarteten Preisen abdeckt. Falls nicht, wenden Sie sich an Ihren Google-Vertriebsmitarbeiter oder Ihren Partner, um zu besprechen, wie Sie diese API einbinden können.

Allgemeine Änderungen

Hier einige allgemeine Änderungen, die für mehrere APIs gelten:

  • Es wird ein neues Preismodell verwendet. Preisinformationen für alle APIs finden Sie unter Places SDK for Android (New).

  • Sie müssen Ihre App initialisieren, indem Sie die Methode Places.initializeWithNewPlacesApiEnabled() aufrufen. Weitere Informationen zum Auswählen des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.

  • Für Place Details (New), Nearby Search (New) und Text Search (New) sind Feldmasken erforderlich, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen.

  • Es wurden neue Klassen hinzugefügt, um die Anfragen zu definieren oder der Antwort neue Felder hinzuzufügen.

  • Das Antwortobjekt Place enthält die neue Methode getReviews(), die eine Liste von Review-Objekten zurückgibt. Wenn in Ihrer App Informationen angezeigt werden, die aus dem Place-Objekt stammen, z. B. Fotos und Rezensionen, müssen auch die erforderlichen Quellenangaben eingeblendet werden.

    Weitere Informationen finden Sie in der Dokumentation zu Quellenangaben.

API-spezifische Änderungen

Dieser Abschnitt enthält die folgenden Migrationsleitfäden für jede API: