Das Places SDK for Android unterstützt die vorhandenen Informationen zu Örtlichkeiten. Wenn Sie mit dem vorhandenen Places SDK for Android vertraut sind, sind in der neuen Version von „Place Details“ die folgenden Änderungen zu beachten:
Es wird ein neues Preismodell verwendet. Preisinformationen zu allen APIs finden Sie unter Places SDK for Android (neu).
Sie müssen Ihre App initialisieren, indem Sie die Methode
Places.initializeWithNewPlacesApiEnabled()aufrufen. Weitere Informationen zur Auswahl des Places API-Dienstes finden Sie unter Google Cloud-Projekt einrichten.Feldmaskierung ist erforderlich. Sie müssen angeben, welche Felder in der Antwort zurückgegeben werden sollen. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste weglassen, geben die Methoden einen Fehler zurück.
In den folgenden Abschnitten werden weitere Änderungen beschrieben.
Auf neue Ortstypen zugreifen
Mit jedem Ort können einer oder mehrere Typ-Werte verknüpft sein. Das Places SDK for Android ab Version 3.3.0 enthält viele neue Typenwerte. Eine vollständige Liste finden Sie unter Erweiterte Ortstypen.
Die Methode Place.getPlaceTypes() gibt die Typwerte als Liste von Stringwerten zurück. Die zurückgegebenen Werte hängen von der Version des Places SDK for Android ab:
Places SDK for Android (neu): Hier werden die Strings zurückgegeben, die in den Tabellen A und B unter Ortstypen (neu) definiert sind, einschließlich aller Ortstypen, die in Version 3.3.0 hinzugefügt wurden.
Places SDK for Android: Hier werden die von
Place.Typesdefinierten Enumerationen zurückgegeben. Die neuen Typen, die in Version 3.3.0 und höher hinzugefügt wurden, sind nicht enthalten.
Auf Rezensionen zu Orten zugreifen
Das Places SDK for Android (New) enthält die Klasse Review, die eine Rezension eines Orts enthält. Das Place-Objekt kann bis zu fünf Rezensionen enthalten.
Die Review-Klasse kann auch eine Quellenangabe und eine Autorenangabe enthalten. Wenn Sie die Rezension in Ihrer App anzeigen, müssen Sie auch die Quellenangabe oder Autorangabe anzeigen. Weitere Informationen finden Sie unter Rezensionen anzeigen.
Weitere Informationen finden Sie in der Dokumentation zu Attributionen.
Sprachcode für Ortsnamen
Die vorhandene Methode Place.getName() gibt einen Textstring mit dem Namen eines Orts zurück. Wenn Sie das Place-Objekt mit dem Ortsnamen füllen möchten, müssen Sie Place.Field.DISPLAY_NAME in die Feldliste der Places Details-Anfrage aufnehmen.
Das Place-Objekt enthält jetzt den Sprachcode für den Namensstring. Wenn Sie das Place-Objekt mit einem Sprachcode ausfüllen möchten, müssen Sie Folgendes tun:
Fügen Sie
Place.Field.DISPLAY_NAMEin die Feldliste der Anfrage ein. Mit diesem Wert wird die Antwort so konfiguriert, dass sie sowohl den Ortsnamen als auch den Sprachcode imPlace-Objekt enthält.Rufen Sie
PlacesClient.fetchPlace()an.PlacesClient.findCurrentPlace()unterstützt das Feld „Sprachcode“ nicht.Verwenden Sie die Methode
Place.getNameLanguageCode(), um auf das Feld „Sprachcode“ imPlace-Objekt zuzugreifen.
Regionscode festlegen
Im Places SDK for Android (neu) wird der Anfrageparameter „Regioncode“ zu den Details zum Ort hinzugefügt. Der Regionscode wird zum Formatieren der Antwort verwendet und als zweistelliger CLDR-Code angegeben. Dieser Parameter kann auch eine Verzerrung der Suchergebnisse bewirken. Es gibt keinen Standardwert. Sie müssen das neue SDK aktivieren, um den Regionscode festzulegen.
Wenn der Ländername des Adressfelds in der Antwort mit dem Regionscode übereinstimmt, wird der Ländercode aus der Adresse entfernt.
Die meisten CLDR-Codes stimmen mit ISO 3166-1-Codes überein, mit einigen Ausnahmen. Die ccTLD des Vereinigten Königreichs ist beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ ist (technisch für die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“). Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden.
Beispielanfrage
Ein vollständiges Beispiel finden Sie unter Standortdetails (neu).