Ortsdetails (neu)

Sie können weitere Details zu einer bestimmten Einrichtung oder Filiale anfordern. indem Sie anhand der entsprechenden ID eingeben und eine „Place Details (New)“-Anfrage „Place Details (New)“ gibt ein umfassenderes Bild zurück Informationen zum angegebenen Ort wie die vollständige Adresse, Telefonnummer Nutzerbewertungen und Rezensionen.

Es gibt viele Möglichkeiten, eine Orts-ID zu erhalten. Sie können Folgendes angeben:

• Textsuche (neu)
• Nearby Search (neu)
• Automatische Vervollständigung (neu)

„Place Details (New)“-Anfragen

Sie können Details zum Ort anfordern, indem Sie folgenden Link aufrufen: PlacesClient.fetchPlace() und übergeben eine FetchPlaceRequest Objekt mit einer Orts-ID und einer Feldliste sowie als beliebige optionale Parameter:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

„Place Details (New)“-Antworten

„Place Details (New)“ gibt Daten in Form einer Place -Objekt, das nur die Felder enthält, die Sie über das -Feld angefordert haben. Liste Ergebnisse für „Place“-Daten dürfen nicht leer sein, sodass nur „Place“-Ergebnisse mit Daten zurückgegeben werden (z. B. wenn ein angefragter Ort keine Fotos hat, ist im Ergebnis nicht vorhanden).

Um auf Datenfelder zuzugreifen, rufen Sie die entsprechende method zu verwenden. Wenn Sie beispielsweise auf den Ortsnamen zugreifen möchten, rufen Sie getName() auf.

Erforderliche Parameter

Die erforderlichen Parameter für FetchPlaceRequest sind:

• Orts-ID

  Eine ID in Textform, die einen Ort eindeutig identifiziert. Sie wird von einem Text Search (New), Nearby Search (New) oder Automatische Vervollständigung (neu): Weitere Informationen zu Orts-IDs finden Sie in der Orts-ID-Übersicht.

• Liste der Felder

  Wenn Sie einen Ort anfragen, müssen Sie angeben, welche Ortsdaten zurückgegeben werden sollen. Bis übergeben Sie hierfür eine Liste mit Place.Field-Werten und gibt die Daten an, die zurückgegeben werden sollen. Es gibt keine Standardliste zurückgegebene Felder in der Antwort.

  Feldlisten eignen sich gut, um sicherzustellen, um unnötige Daten zu verarbeiten, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.Diese Liste ist ein wichtiger Faktor, da sich dies auf die Kosten für die einzelnen Anfragen auswirkt. Weitere Informationen finden Sie unter Verwendung und Abrechnung.

  Geben Sie eines oder mehrere der folgenden Felder an:

  • Die folgenden Felder lösen die SKU „Place Details (IDs Only)“ aus:

    Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

  • Die folgenden Felder lösen die SKU „Place Details (Location Only)“ aus:

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT.

  • Die folgenden Felder lösen die SKU Place Details (Basic) aus:

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

  • Die folgenden Felder lösen die SKU Place Details (Advanced) aus:

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

  • Die folgenden Felder lösen die SKU Place Details (Preferred) aus:

    <ph type="x-smartling-placeholder"></ph> Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

Optionale Parameter

Die optionalen Parameter für FetchPlaceRequest sind:

• Regionscode

  Der Regionscode, der zum Formatieren der Antwort verwendet wird, angegeben als <ph type="x-smartling-placeholder"></ph> zweistelligen CLDR-Code eingeben. Es gibt keinen Standardwert.

  Wenn der Ländername im Feld Place.Field.ADDRESS in der Antwort mit dem regionCode wird der Ländercode bei Place.Field.ADDRESS weggelassen.

  Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen nennenswerten Ausnahmen. Die ccTLD des Vereinigten Königreichs lautet beispielsweise "uk" (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit des Vereinigten Königreichs Großbritannien und Nordirland“). Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.

  Wenn Sie den Parameter für den Regionscode festlegen möchten, rufen Sie beim Erstellen des FetchPlaceRequest-Objekts die Methode setRegionCode() auf.

• Sitzungstoken

  Sitzungstokens sind vom Nutzer erstellte Strings, Autocomplete (New)-Aufrufe werden als „Sitzungen“ bezeichnet. Bei Autocomplete (New) werden Sitzungstokens verwendet, um Die Phasen „Abfrage“ und „Ortsauswahl“ einer Suche mit automatischer Vervollständigung durch Nutzer in einer separaten Sitzung gruppieren zu Abrechnungszwecken. Sitzungstokens werden an „Place Details (New)“ übergeben Aufrufe, die auf „Autocomplete“-Aufrufe („Neu“) folgen. Weitere Informationen finden Sie unter Sitzungstokens

  Rufen Sie zum Festlegen des Sitzungstoken-Parameters beim Erstellen des FetchPlaceRequest-Objekts die Methode setSessionToken() auf.

Beispiel für „Place Details“

Im folgenden Beispiel werden die Felder ID, NAME und ADDRESS für die Empire State Building in New York City.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);