Migration – Übersicht

Das Places SDK for iOS (New) bietet eine verbesserte Leistung und ein neues Preismodell. Daher lohnt es sich, Apps zu aktualisieren, die das Places SDK for iOS (Legacy) verwenden. Weitere Informationen zum Vergleich der Funktionen finden Sie unter SDK auswählen.

In dieser Anleitung werden die wichtigsten Unterschiede zwischen dem Places SDK for iOS (New) und dem Places SDK for iOS (Legacy) erläutert und Sie erfahren, wie Sie die erforderlichen Änderungen vornehmen.

Best Practices für die Abrechnung bei der Migration

Diese Anleitung gilt, wenn Ihre API-Nutzung so hoch ist, dass Sie in die zweite Preisstufe wechseln. Wenn Sie zu einer neueren Version einer API migrieren, wird Ihnen auch eine andere SKU in Rechnung gestellt. Um höhere Kosten im Migrationsmonat zu vermeiden, empfehlen wir, so früh wie möglich im Monat zu den neuen APIs in der Produktion zu wechseln. So erreichen Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen. Informationen zu den Preisstufen finden Sie auf der Preisseite und in den FAQs zu den Preisen.

Fehler: kGMSPlacesRateLimitExceeded

Places API (New)

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

Anschließend müssen Sie prüfen, ob Sie 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 Use API Keys.

Prüfen, ob in der Places API (New) ausreichend Kontingent vorhanden ist

Achten Sie darauf, dass im Places SDK for iOS (New) ausreichend Kontingent vorhanden ist, um Ihren aktuellen Traffic im Places SDK for iOS abzudecken. Informationen zum Prüfen und Verwalten Ihrer Kontingente und Nutzungslimits finden Sie unter Kontingente und Kontingent benachrichtigungen. Beachten Sie die Unterschiede zwischen den beiden APIs:

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

Prüfen, ob Ihre Vereinbarung die Places API (New) umfasst

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

Allgemeine Änderungen

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

  • Verwendet ein neues Preismodell. Informationen zu den Preisen für alle APIs finden Sie unter Preise für das Places SDK for iOS (New).

  • 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.

  • GMSPlacesClient enthält neue Methoden zum Aufrufen dieser neuen APIs.

  • Es wurden neue Klassen hinzugefügt, um die Anfrage an jede der neuen APIs zu definieren.

  • Die Antwortinstanz GMSPlace enthält das neue Attribut reviews vom Typ GMSPlaceReview. Wenn in Ihrer App Informationen angezeigt werden, die aus der GMSPlace-Instanz stammen, z. B. Fotos und Rezensionen, müssen auch die erforderlichen Quellenangaben angezeigt werden.

    Weitere Informationen finden Sie in der Dokumentation zu Quellenangaben.

API-spezifische Änderungen

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