Einführung
Mit der Places API können Sie anhand eines Textstrings oder nach 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 dieser Anleitung erfahren Sie mehr über die wichtigsten Unterschiede zwischen den beiden APIs und wie Sie zur Places API (New) migrieren.
| Places API (Legacy) | Places API (New) | Hinweise |
|---|---|---|
| Ortssuche (Legacy) | Textsuche (Neu) | Es gibt keine neue Version von „Find Place“ (Legacy). „Text Search (New)“ hat die Funktion ersetzt. |
| Nearby Search (Legacy) | Nearby Search (New) | Für alle Anfragen, die die alte API verwenden und eine Textanfrage enthalten, sollte Text Search (New) verwendet werden, da Nearby Search (New) keine Texteingabe unterstützt. |
| Textsuche (Legacy) | Textsuche (Neu) | |
| Ortsdetails (Legacy) | Ortsdetails (neu) | |
| Ortsfotos (Legacy) | Ortsfotos (neu) | |
| 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
- Zu Text Search (Neu) migrieren
- Zu Place Details (neu) migrieren
- Zu Ortsfotos (neu) migrieren
- Zu Autocomplete migrieren (neu)
Wichtige neue Funktionen in der Places API (neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die der Places API (New) hinzugefügt wurden.
Auf der Google Cloud-Standardplattform implementiert
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 Standard-API-Design sorgt für eine gewisse Konsistenz zwischen den APIs, was die Effizienz der Entwicklung mit der Places API (New) verbessert.
Verbesserte Leistung
Die Places API (New) bietet eine bessere Leistung, sodass es sich lohnt, Apps zu ersetzen, die die vorhandene Places API verwenden.
Transparente Kosten
Die Preise für die Places API (New) sind vereinfacht. Sie zahlen nur für die Daten, 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 alten APIs wurden mit den APIs „Place Details (Legacy)“, „Nearby Search (Legacy)“ und „Text Search (Legacy)“ unterschiedliche Antwortdaten für einen Ort zurückgegeben. Bei der Places API (New) wird die Antwort standardisiert, 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 für eine Tankstelle. Mit diesen Antwortfeldern können Sie dynamische Nutzererlebnisse schaffen.