Places SDK for Android (Legacy) – Übersicht

In diesem Leitfaden werden die wichtigsten Unterschiede zwischen den SDK-Versionen beschrieben und Sie erfahren, wie Sie zum Places SDK for Android (neu) 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-Version	Initialisierungsmethode	Mindest-SDK-Version
Automatische Vervollständigung (neu)	Places API (New)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Details (New)	Places API (New)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (New)	Places API (New)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (New)	Places API (New)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (New)	Places API (New)	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)

Zu den neuen APIs migrieren

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

• Zu Place Details (New) migrieren
• Zu „Place Photos (New)“ migrieren
• Zu Autocomplete (New) migrieren

Verbesserungen im Places SDK for Android (neu)

In diesem Abschnitt werden die wichtigsten Funktionen des Places SDK for Android (New) beschrieben.

Implementiert auf der Google Cloud-Standardplattform

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 Konsistenz zwischen den SDKs, was die Entwicklung mit dem Places SDK for Android (neu) effizienter macht.

Verbesserte Leistung

Das Places SDK for Android (New) bietet eine verbesserte Leistung. Es lohnt sich also, Apps, die das bestehende SDK verwenden, zu ersetzen.

Neue Funktionen

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

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

Text Search (New)

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 zu „Place Details (New)“ und „Place Photos (New)“ hinzugefügt

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

• Place Photos (New) fügt der Klasse PhotoMetadata die Methode AuthorAttributions hinzu. AuthorAttributions enthält ein List mit AuthorAttribution-Objekten.

Neue URI-Antwort zu „Place Photos (New)“ hinzugefügt

Sie können jetzt Place Photos (New) verwenden, um einen URI zu einer Bild-Bitmap zurückzugeben. Bisher konnte nur die Bild-Bitmap selbst zurückgegeben werden.

Vereinfachte Preisgestaltung

Die Preisgestaltung für das Places SDK for Android (New) wurde vereinfacht, sodass Sie nur für die Daten bezahlen, die Sie verwenden. Die vereinfachte Preisgestaltung wird mithilfe von Feldlisten, auch Feldmasken genannt, implementiert.

Bei „Place Details (New)“ und „Text Search (New)“ können Sie mit Feldlisten die Liste der Felder 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 Preisinformationen finden Sie unter Nutzung und Abrechnung.

Erweiterte Ortstypen

Das neue SDK enthält neue Ortstypen, die im Rahmen der Antwort von „Place Details (New)“ und „Text Search (New)“ zurückgegeben werden. Sie können diese neuen und die vorhandenen Typen auch in einer Suche mit Text Search (New) verwenden. Die neuen Typen sind in Tabelle A enthalten.