Ortsdetails (neu)

Plattform auswählen: Android iOS JavaScript Webdienst

Entwickler im Europäischen Wirtschaftsraum (EWR)

Sie können weitere Informationen zu einem bestimmten Unternehmen oder Point of Interest anfordern, indem Sie die Place ID verwenden und eine Place Details (New)-Anfrage stellen. Bei Place Details (New) werden umfassendere Informationen zum angegebenen Ort zurückgegeben, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertungen oder Rezensionen.

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

„Place Details (New)“-Anfragen

Sie können Ortsdetails anfordern, indem Sie PlacesClient.fetchPlace() aufrufen und ein FetchPlaceRequest-Objekt mit einer Orts-ID und einer Feldliste sowie optionalen Parametern} übergeben:

// 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 Feldliste angefordert haben. Ergebnisse für „Place Details“-Anfragen dürfen nicht leer sein. Daher werden nur Ergebnisse mit Daten zurückgegeben. Wenn für einen angeforderten Ort beispielsweise keine Fotos vorhanden sind, ist das Feld „photos“ nicht im Ergebnis enthalten.

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 Text Search (New), Nearby Search (New) oder Autocomplete (New) zurückgegeben. Weitere Informationen zu Orts-IDs 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.

    Mit Feldlisten lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.Diese Liste ist wichtig, da sie die Kosten für jede Anfrage beeinflusst. Weitere Informationen finden Sie unter Nutzung und Abrechnung.

    Geben Sie eines oder mehrere der folgenden Felder an:

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

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

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

      Place.Field.ADDRESS_COMPONENTS
      ADR_FORMAT_ADDRESS
      Place.Field.FORMATTED_ADDRESS*
          * Wird anstelle von Place.Field.ADDRESS (eingestellt) verwendet.
      Place.Field.LOCATION*
          * Wird anstelle von Place.Field.LAT_LNG (eingestellt) verwendet.
      Place.Field.PLUS_CODE
      Place.Field.SHORT_FORMATTED_ADDRESS
      Place.Field.TYPES
      Place.Field.VIEWPORT

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

      Place.Field.ACCESSIBILITY_OPTIONS*
          * Wird anstelle von Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (eingestellt) verwendet.
      Place.Field.BUSINESS_STATUS
      Place.Field.DISPLAY_NAME*
          * Verwenden Sie diese Option anstelle von Place.Field.NAME, das eingestellt wurde.
      Place.Field.GOOGLE_MAPS_URI
      Place.Field.ICON_BACKGROUND_COLOR
      Place.Field.ICON_MASK_URL*
          * Anstelle von Place.Field.ICON_URL (eingestellt).
      Place.Field.PRIMARY_TYPE
      Place.Field.PRIMARY_TYPE_DISPLAY_NAME
      Place.Field.SUB_DESTINATIONS
      Place.Field.UTC_OFFSET

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

      Place.Field.CURRENT_OPENING_HOURS
      Place.Field.CURRENT_SECONDARY_OPENING_HOURS
      Place.Field.INTERNATIONAL_PHONE_NUMBER*
          * Verwenden Sie diese Option anstelle von Place.Field.PHONE_NUMBER, die eingestellt wurde.
      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 diese Option anstelle von Place.Field.USER_RATINGS_TOTAL, da diese veraltet ist.
      Place.Field.WEBSITE_URI

    • Die folgenden Felder lösen die Place Details Enterprise Plus-SKU 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 zum Formatieren der Antwort verwendete Regionscode, angegeben als zweistelliger CLDR-Code. Es gibt keinen Standardwert.

    Wenn der Ländername des Felds Place.Field.FORMATTED_ADDRESS 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. Es gibt jedoch einige Ausnahmen. Die ccTLD des Vereinigten Königreichs ist beispielsweise „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch für das Land „Vereinigtes Königreich von Großbritannien und Nordirland“). Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

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

  • Sitzungstoken

    Sitzungstokens sind von Nutzern generierte Strings, mit denen Autocomplete-Aufrufe (Neu) als „Sitzungen“ erfasst werden. Bei Autocomplete (New) werden Sitzungstokens verwendet, um die Abfrage- und Ortsauswahlphasen einer Nutzeranfrage zur automatischen Vervollständigung zu Abrechnungszwecken zu einer separaten Sitzung zusammenzufassen. Sitzungstokens werden in „Place Details (New)“-Aufrufe übergeben, die auf „Autocomplete (New)“-Aufrufe folgen. Weitere Informationen finden Sie unter Sitzungstokens.

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

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);