Migration – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

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

In diesem Leitfaden werden die wichtigsten Unterschiede zwischen der Places API (New) und der Places API (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 Monat der Umstellung 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.

Places API (New) aktivieren

Wenn Sie die Funktionen der Places API (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.

Außerdem müssen Sie die Places API (New) dem API Schlüssel hinzufügen, der von Ihrer App verwendet wird. Weitere Informationen finden Sie unter API Schlüssel verwenden.

Allgemeine Änderungen

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

  • Alle neuen APIs unterstützen sowohl API-Schlüssel als auch OAuth Tokens als Authentifizierungsmechanismus.
  • Nur JSON wird als Antwortformat unterstützt.
  • Für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ ist eine Feldmaskierung erforderlich, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen. Weitere Informationen finden Sie unter FieldMask.
  • Die APIs „Nearby Search (New)“ und „Text Search (New)“ geben jetzt die vollständigen Ortsdetails zurück, die mit den Ortsdetails übereinstimmen, die von „Place Details (New)“ zurückgegeben werden.
  • Das JSON-Antwortformat für die APIs „Place Details (New)“, „Nearby Search (New)“, und „Text Search (New)“ hat sich gegenüber dem Format der vorhandenen APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.

API-spezifische Änderungen

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