Mit dem Places SDK können Sie anhand eines Textstrings oder nach Nähe nach Informationen zu verschiedenen Ortstypen suchen und diese abrufen. Das Places SDK ist die alte Version des Places SDK (New).
In dieser Anleitung erfahren Sie mehr über die wichtigsten Unterschiede zwischen den Places SDK-Versionen und wie Sie zum neuen Places SDK migrieren.
In den einzelnen Versionen verfügbare SDK-Funktionen
In der folgenden Tabelle sehen Sie, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:
| Funktion | Places API für API-Schlüssel aktiviert | Initialisierungsmethode | Mindestversion des SDKs |
|---|---|---|---|
| Automatische Vervollständigung (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Ortsdetails (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (New) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Ortsfotos (neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Textsuche (Neu) | Places API (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | Places API | initialize() |
|
| Find Current Place | Places API | initialize() |
|
| Place Details | Places API | initialize() |
|
| Ortsfotos | Places API | initialize() |
Zu den neuen APIs migrieren
Informationen zur Migration zu den neuen APIs finden Sie in den folgenden Migrationsanleitungen:
Verbesserungen im Places SDK for Android (Neu)
In diesem Abschnitt werden die wichtigsten Funktionen beschrieben, die dem Places SDK for Android (New) hinzugefügt wurden.
Auf der Google Cloud-Standardplattform implementiert
Das Places SDK for Android (New) wird in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung sorgt für eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für eine gewisse Einheitlichkeit zwischen den SDKs, was die Entwicklung mit dem Places SDK for Android (New) effizienter macht.
Verbesserte Leistung
Das Places SDK for Android (New) bietet eine verbesserte Leistung, sodass es sich lohnt, Apps, in denen das vorhandene SDK verwendet wird, zu ersetzen.
Neue Funktionen
Das Places SDK for Android (New) enthält die neuesten Versionen aller SDK-Funktionen:
- Automatische Vervollständigung (neu)
- Ortsdetails (neu)
- Nearby Search (New)
- Ortsfotos (neu)
- Textsuche (Neu)
Neuer Text Search-Dienst
Bei Verwendung von Text Search (New) werden Informationen zu verschiedenen Orten auf Grundlage eines Textstrings zurückgegeben, z. B. „Pizza in München“, „Schuhgeschäfte in der Nähe von Hamburg“ oder „Hauptstraße 123“. Der Dienst gibt eine Liste mit Orten zurück, die dem Textstring und ggf. der festgelegten Standortgewichtung entsprechen.
Neue Antwortdaten für „Place Details (New)“ und „Place Photos (New)“
Place Details (Neu) enthält jetzt die neue Review-Klasse im Antwortobjekt
Place. Die Klasse Place enthält die neue MethodegetReviews()zur Unterstützung dieses Felds. Rufen SiegetReviews()auf, um bis zu fünf Rezensionen für einen Ort zurückzugeben.Ortsfoto (Neu) fügt der Klasse
PhotoMetadatadieAuthorAttributionshinzu.AuthorAttributionsenthält einListmitAuthorAttribution-Objekten.
Neue URI-Antwort für „Place Photos (New)“ hinzugefügt
Mit Place Photo (Neu) können Sie jetzt einen URI für eine Bild-Bitmap zurückgeben. Bisher konnten Sie nur die Bild-Bitmap zurückgeben.
Transparente Kosten
Die Preise für das Places SDK for Android (New) sind einfacher, da Sie nur für die verwendeten Daten bezahlen. Die vereinfachte Preisgestaltung wird mithilfe von Feldlisten, auch Feldmasken genannt, implementiert.
Bei Place Details und Text Search verwenden Sie Feldlisten, 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 Feldlisten lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.
Ausführliche Preisinformationen für beide SDKs finden Sie unter Nutzung und Abrechnung.
Erweiterte Ortstypen
Das neue SDK enthält neue Ortstypen, die im Rahmen der Antwort von „Place Details“ und „Text Search“ zurückgegeben werden. Sie können diese neuen Typen und die vorhandenen Typen auch in einer Suche mit Text Search verwenden. Die neuen Typen sind in Tabelle A enthalten.