Einführung
Die Places API (New) bietet eine bessere Leistung und ein neues Preismodell. Es lohnt sich also, Apps zu aktualisieren, die die Places API (Legacy) verwenden. Weitere Informationen zum Vergleichen von 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. Außerdem wird beschrieben, wie Sie die erforderlichen Ä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 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, die neuen APIs in der Produktion möglichst am Anfang des Monats zu aktivieren. So erreichen Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen. Informationen zu den Preisstufen finden Sie auf der Preisseite und in den häufig gestellten Fragen zu 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.
Anschließend 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 als Authentifizierungsmechanismus.
- Als Antwortformat wird nur JSON unterstützt.
- Feldmasken sind für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ 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 von Place Details (New) zurückgegebenen Ortsdetails übereinstimmen.
- Das JSON-Antwortformat für die APIs Place Details (New), Nearby Search (New) und Text Search (New) hat sich im Vergleich zum Format der bestehenden APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
API-spezifische Änderungen
Dieser Abschnitt enthält die folgenden Migrationsanleitungen für die einzelnen APIs:
- Zu Nearby Search (New) migrieren
- Auf Text Search (New) migrieren
- Zu Place Details (New) migrieren
- Zu „Place Photos (New)“ migrieren
- Zu Autocomplete (New) migrieren