Übersicht über die Migration

Das Places SDK for iOS (New) bietet eine verbesserte Leistung und ein neues Preismodell. Es lohnt sich also, Apps, in denen das Places SDK for iOS (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 iOS (Neu) und dem Places SDK for iOS (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.

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 die 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 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 im Places SDK for iOS (New) genügend 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 Kontingentbenachrichtigungen. 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. Sie ist die Summe aller Places API-Methoden.
  • Das Kontingent für das Places SDK for iOS (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 ausgehandelte Vereinbarung haben, prüfen Sie, ob sie die Places API (New) mit den erwarteten Preisen abdeckt. Falls nicht, wenden Sie sich an Ihren Vertriebsmitarbeiter bei Google oder an 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

  • 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 die einzelnen neuen APIs zu definieren.

  • Die Antwortinstanz GMSPlace enthält das neue Attribut reviews vom Typ GMSPlaceReview. Wenn in Ihrer App Informationen angezeigt werden, die von der GMSPlace-Instanz abgerufen wurden, 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: