Ortsdetails (neu)

Sie können weitere Details zu einem bestimmten Unternehmen oder Ort von Interesse anfordern, indem Sie die Orts ID verwenden und eine „Place Details (New)“-Anfrage stellen. „Place Details (New)“ gibt umfassendere Informationen zum angegebenen Ort zurück, z. B. 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 Ortsdetails anfordern, indem Sie PlacesClient.fetchPlace() aufrufen und ein FetchPlaceRequest -Objekt übergeben, das eine Orts-ID und eine Feldliste sowie optionale Parameter enthält:

// 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 eines Place -Objekts zurück, das nur die Felder enthält, die Sie mit der Feld liste angefordert haben. Ergebnisse mit Ortsdaten können nicht leer sein. Daher werden nur Ergebnisse mit Ortsdaten zurückgegeben. Wenn ein angeforderter Ort beispielsweise keine Fotos hat, ist das Feld „photos“ nicht im Ergebnis vorhanden.

Rufen Sie die entsprechende Methode auf, um auf Datenfelder zuzugreifen. 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, über die ein Ort eindeutig identifiziert wird. Sie wird von einer Textsuche (neu), Nearby Search (neu), oder automatischer Vervollständigung (neu) zurückgegeben. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.

• Feldliste

  Wenn Sie einen Ort anfordern, müssen Sie angeben, welche Ortsdaten zurückgegeben werden sollen. Übergeben Sie dazu eine Liste von Place.Field-Werten, die die zurückzugebenden Daten angeben. Es gibt keine Standardliste der zurückgegebenen Felder in der Antwort.

  Feldlisten sind eine gute Möglichkeit, unnötige Datenanfragen zu vermeiden. Dadurch können Sie unnötige Verarbeitungszeiten und Gebühren vermeiden. Diese Liste ist wichtig, da sie sich auf die Kosten für jede Anfrage auswirkt. Weitere Informationen finden Sie unter Nutzung und Abrechnung.

  Geben Sie eines oder mehrere der folgenden Felder an:

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

    Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
    

  • Die folgenden Felder lösen die SKU „Place Details Essentials“ aus:

    Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
        * Verwenden Sie stattdessen Place.Field.ADDRESS (verworfen).
    Place.Field.LOCATION*
        * Verwenden Sie stattdessen Place.Field.LAT_LNG (verworfen).
    Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

  • Die folgenden Felder lösen die SKU „Place Details Pro“ aus:

    Place.Field.ACCESSIBILITY_OPTIONS*
        * Verwenden Sie stattdessen Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (verworfen).
    Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
        * Verwenden Sie stattdessen Place.Field.NAME (verworfen).
    Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
        * Verwenden Sie stattdessen Place.Field.ICON_URL (verworfen).
    Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

  • Die folgenden Felder lösen die SKU „Place Details Enterprise“ aus:

    Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
        * Verwenden Sie stattdessen Place.Field.PHONE_NUMBER (verworfen).
    Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
        * Verwenden Sie stattdessen Place.Field.USER_RATINGS_TOTAL (verworfen).
    Place.Field.WEBSITE_URI

  • Die folgenden Felder lösen die SKU „Place Details Enterprise Plus“ aus:

    Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
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. Er wird als CLDR-Code mit zwei Zeichen angegeben. Es gibt keinen Standardwert.

  Wenn der Ländername des Place.Field.FORMATTED_ADDRESS-Felds in der Antwort mit regionCode übereinstimmt, wird der Ländercode aus Place.Field.FORMATTED_ADDRESS entfernt.

  Die meisten CLDR-Codes sind mit den ISO 3166-1-Codes identisch, mit einigen bemerkenswerten Ausnahmen. Die ccTLD des Vereinigten Königreichs ist beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Einheit „Vereinigtes Königreich Großbritannien und Nordirland“). Der Parameter kann sich je nach geltendem Recht auf die Ergebnisse auswirken.

  Rufen Sie zum Festlegen des Parameters für den Regionscode die setRegionCode() Methode auf, wenn Sie das FetchPlaceRequest Objekt erstellen.

• Sitzungstoken

  Sitzungstokens sind nutzergenerierte Strings, mit denen Aufrufe der automatischen Vervollständigung (neu) als „Sitzungen“ erfasst werden. In der automatischen Vervollständigung (neu) werden Sitzungstokens verwendet, um die Abfrage- und Ortsauswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen. Sitzungstokens werden an „Place Details (New)“ Aufrufe übergeben, die auf Aufrufe der automatischen Vervollständigung (neu) folgen. Weitere Informationen finden Sie unter Sitzungstokens.

  Rufen Sie zum Festlegen des Parameters für das Sitzungstoken die setSessionToken() Methode auf, wenn Sie das FetchPlaceRequest Objekt erstellen.

Beispiel für „Place Details“

Im folgenden Beispiel werden die Felder ID, DISPLAY_NAME und FORMATTED_ADDRESS für das Empire State Building in New York City angefordert.

// 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.DISPLAY_NAME, Place.Field.FORMATTED_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);