Die Places API (New) bietet eine verbesserte Leistung und ein neues Preismodell. Daher lohnt es sich, Apps zu aktualisieren, die die Places API verwenden. Weitere Informationen zum Vergleichen von Funktionen finden Sie unter API auswählen.
In diesem Leitfaden erfahren Sie, welche Unterschiede es zwischen der neuen Places API und der Places API gibt und wie Sie die erforderlichen Änderungen vornehmen.
Best Practices für die Abrechnung bei der Migration
Diese Hinweise gelten, 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 erhöhte Kosten im Monat der Umstellung zu vermeiden, empfehlen wir, so nah wie möglich am Monatsanfang auf die neuen APIs umzustellen. So können Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen erreichen. Informationen zu 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 Places API (New) in Ihrem Google Cloud-Projekt aktivieren. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.
Achten Sie darauf, dass Sie dem von Ihrer App verwendeten API-Schlüssel Places API (New) hinzugefügt haben. Weitere Informationen finden Sie unter API-Schlüssel verwenden.
Allgemeine Änderungen
Zu den allgemeinen Änderungen, die für mehrere APIs gelten, gehören:
- Alle neuen APIs unterstützen sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
- Als Antwortformat wird nur JSON 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 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) unterscheidet sich vom Format der vorhandenen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
API-spezifische Änderungen
In diesem Abschnitt finden Sie die folgenden Migrationsanleitungen für jede API: