Das Places SDK for Android unterstützt die vorhandenen Place Details. 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.Die 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
Jedem Ort können ein oder mehrere Typ-Werte zugeordnet sein. Das Places SDK für Android-Version 3.3.0 und höher 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 (neu) 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 Quellen- oder Autorenangabe anzeigen. Weitere Informationen finden Sie unter Rezensionen anzeigen.
Weitere Informationen finden Sie in der Dokumentation zu Attributionen.
Sprachcode für Ortsnamen aufrufen
Die vorhandene Methode Place.getName() gibt einen Textstring zurück, der den Namen eines Orts enthält. Wenn Sie das Place-Objekt mit dem Ortsnamen füllen möchten, müssen Sie Place.Field.DISPLAY_NAME in die Feldliste der Anfrage für „Place Details“ aufnehmen.
Das Place-Objekt enthält jetzt den Sprachcode für den Namensstring. Um das Place-Objekt mit einem Sprachcode zu füllen, 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 sowohl der Ortsname als auch der Sprachcode imPlace-Objekt enthalten sind.Rufen Sie
PlacesClient.fetchPlace()an.PlacesClient.findCurrentPlace()unterstützt das Feld „Sprachcode“ nicht.Mit der Methode
Place.getNameLanguageCode()können Sie auf das Feld „Sprachcode“ imPlace-Objekt zugreifen.
Regionscode festlegen
Im Places SDK for Android (neu) wird der Anfrageparameter „Region Code“ zu „Place Details“ hinzugefügt. Der Regionscode wird zum Formatieren der Antwort verwendet und als zweistelliger CLDR-Code angegeben. Dieser Parameter kann auch die Suchergebnisse beeinflussen. Es gibt keinen Standardwert. Sie müssen das neue SDK aktivieren, um den Regionscode festzulegen.
Wenn der Name des Landes im Adressfeld in der Antwort mit dem Regionscode übereinstimmt, wird der Ländercode aus der Adresse entfernt.
Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (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 Place Details (neu).