Einführung
Mit der Places API können Sie anhand eines Textstrings oder der Nähe nach Informationen zu verschiedenen Ortstypen suchen und diese abrufen. Die Places API (Legacy) ist die alte Version der Places API (New).
In der folgenden Tabelle sind die entsprechenden Versionen der beiden APIs aufgeführt. In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den beiden APIs erläutert und Sie erfahren, wie Sie zur Places API (New) migrieren.
| Places API (Legacy) | Places API (New) | Hinweise |
|---|---|---|
| Find Place (Legacy) | Text Search (New) | Es gibt keine neue Version von „Find Place (Legacy)“. Sie wurde durch „Text Search (New)“ ersetzt. |
| Nearby Search (Legacy) | Nearby Search (New) | Für alle Anfragen mit der Legacy API, die eine Textabfrage enthalten, sollte Text Search (New) verwendet werden, da Nearby Search (New) keine Texteingabe unterstützt. |
| Text Search (Legacy) | Text Search (New) | |
| Place Details (Legacy) | Place Details (New) | |
| Place Photos (Legacy) | Place Photos (New) | |
| Place Autocomplete (Legacy) | Automatische Vervollständigung (neu) | |
| Query Autocomplete (Legacy) | Automatische Vervollständigung (neu) | Dem neuen Autocomplete-Dienst wurden Funktionen hinzugefügt. |
Zu den neuen APIs migrieren
Informationen zur Migration zu den neuen APIs finden Sie in den folgenden Migrationsanleitungen:
- Zu Nearby Search (New) migrieren
- Auf Text Search (New) migrieren
- Zu Place Details (New) migrieren
- Zu „Place Photos (New)“ migrieren
- Zu Autocomplete (New) migrieren
Wichtige Funktionen, die der Places API (Neu) hinzugefügt wurden
In diesem Abschnitt werden die wichtigsten Funktionen der Places API (New) beschrieben.
Implementiert auf der Google Cloud-Standardplattform
Die Places API (New) wird in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses standardmäßige API-Design sorgt für eine gewisse Konsistenz zwischen den APIs, was die Entwicklung mit der Places API (New) effizienter macht.
Verbesserte Leistung
Die Places API (New) bietet eine verbesserte Leistung. Es lohnt sich also, Apps, die die bestehende Places API verwenden, zu ersetzen.
Vereinfachte Preisgestaltung
Die Preisgestaltung für die Places API (New) wurde vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie verwenden. Die vereinfachte Preisgestaltung wird mithilfe einer Feldmaske implementiert.
Bei „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ verwenden Sie die Feldmaske, um die Liste der Felder zu steuern, die in der Antwort zurückgegeben werden sollen. Ihnen werden dann nur die angeforderten Daten in Rechnung gestellt. Mit der Maskierung von Feldern lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.
Konsistente Antwortdaten für einen Ort
Bei den Legacy-APIs gaben die APIs „Place Details (Legacy)“, „Nearby Search (Legacy)“ und „Text Search (Legacy)“ unterschiedliche Antwortdaten für einen Ort zurück. Die Places API (New) standardisiert die Antwort, sodass diese APIs alle dieselben Daten für einen Ort zurückgeben.
Erweiterte Ortstypen
Die API-Antwort kann jetzt den primären Typ eines Orts enthalten. Jeder Ort kann einen einzelnen Typwert haben, der als primärer Typ des Orts angegeben wird, wie in Tabelle A aufgeführt.
Die neue API enthält auch mehrere neue Typen. Sie können diese neuen Typen und die vorhandenen Typen in einer Suche mit Nearby Search (New) und Text Search (New) verwenden. Die neuen Typen sind alle in Tabelle A enthalten.
Dynamische Ortsdaten
Die Places API (New) unterstützt dynamische Antwortdaten, z. B. die Verfügbarkeit einer Ladestation für Elektrofahrzeuge oder die aktuellen Kraftstoffpreise einer Tankstelle. Verwenden Sie diese Antwortfelder, um dynamische Nutzererfahrungen zu erstellen.