Places SDK for Android (Legacy) – Übersicht

In dieser Anleitung werden die wichtigsten Unterschiede zwischen den Versionen des Places SDK erläutert und Sie erfahren, wie Sie zum Places SDK for Android (New) migrieren.

In den einzelnen Versionen verfügbare SDK-Funktionen

In der folgenden Tabelle ist aufgeführt, welche SDK- und API-Versionen für die einzelnen SDK-Funktionen erforderlich sind:

Funktion	Places API-Version	Initialisierungsmethode	Mindestversion des SDK
Automatische Vervollständigung (neu)	Places API (neu)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Details (neu)	Places API (neu)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (neu)	Places API (neu)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (neu)	Places API (neu)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (neu)	Places API (neu)	initializeWithNewPlacesApiEnabled()	3.3.0
Place Autocomplete	Places API (Legacy)	initialize() (verworfen)
Find Current Place	Places API (Legacy)	initialize() (verworfen)
Place Details	Places API (Legacy)	initialize() (verworfen)
Place Photos	Places API (Legacy)	initialize() (verworfen)

Verworfen:Die Methode Places.initialize wurde verworfen. Verwenden Sie Places.initializeWithNewPlacesApiEnabled() stattdessen. Hinweis: Um Places.initializeWithNewPlacesApiEnabled() verwenden zu können, müssen Sie die Places API (neu) in der Google Cloud Console für Ihren API-Schlüssel aktivieren.

Zu den neuen APIs migrieren

Informationen zur Migration zu den neuen APIs finden Sie in den folgenden Migrationsanleitungen:

• Zu Place Details (neu) migrieren
• Zu Place Photos (neu) migrieren
• Zu Autocomplete (neu) migrieren

Verbesserungen im Places SDK for Android (New)

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) ist in der Dienst infrastruktur von Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform. Dieses Standarddesign sorgt für eine einheitliche Nutzung der SDKs und verbessert die Effizienz der Entwicklung mit dem Places SDK for Android (New).

Verbesserte Leistung

Das Places SDK for Android (New) bietet eine verbesserte Leistung, sodass sich der Austausch von Apps, die das vorhandene SDK verwenden, lohnt.

Neue Funktionen

Das Places SDK for Android (New) enthält die neuesten Versionen aller SDK-Funktionen:

• Automatische Vervollständigung (neu)
• Place Details (neu)
• Nearby Search (neu)
• Place Photos (neu)
• Text Search (neu)

Text Search (neu)

Bei Verwendung von „Text Search (neu)“ werden Informationen zu verschiedenen Orten auf Grundlage eines Textstrings zurückgegeben, z. B. "Pizza in München" oder "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 zu Place Details (neu) und Place Photos (neu) hinzugefügt

• Place Details (neu) enthält jetzt die neue Klasse „Review“ im Antwortobjekt Place. Die Klasse enthält die neue getReviews() Methode, um dieses Feld zu unterstützen. Rufen Sie getReviews() auf, um bis zu fünf Rezensionen für einen Ort zurückzugeben.

• Place Photos (neu) fügt der Klasse PhotoMetadata die AuthorAttributions hinzu. AuthorAttributions enthält eine List von AuthorAttribution -Objekten.

Neue URI-Antwort zu Place Photos (neu) hinzugefügt

Sie können jetzt mit Place Photos (neu) eine URI zu einer Bildbitmap zurückgeben. Bisher konnten Sie nur die Bildbitmap selbst zurückgeben.

Vereinfachte Preise

Die Preise für das Places SDK for Android (New) wurden vereinfacht, sodass Sie nur für die verwendeten Daten bezahlen. Die vereinfachten Preise werden mithilfe von Feldlisten, auch Feldmasken genannt, implementiert.

Bei Place Details (neu) und Text Search (neu) 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.

Weitere Informationen zu den Preisen finden Sie unter Nutzung und Abrechnung.

Erweiterte Ortstypen

Das neue SDK enthält neue Ortstypen, die als Teil der Antwort von Place Details (neu) und Text Search (neu) zurückgegeben werden. Sie können diese neuen Typen und die vorhandenen Typen auch in einer Suche mit Text Search (neu) verwenden. Die neuen Typen sind in Tabelle A aufgeführt.