Place Details (nouveau)

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Vous pouvez demander plus d'informations sur un établissement ou un point d'intérêt particulier à l'aide de son identifiant de lieu et en envoyant une requête Place Details (New). "Informations sur le lieu (nouvelles)" renvoie des informations plus complètes sur le lieu indiqué, comme son adresse complète, son numéro de téléphone, sa note et ses avis.

Il existe de nombreuses façons d'obtenir un identifiant de lieu. Vous pouvez utiliser :

• Recherche textuelle (nouvelle)
• Nearby Search (Nouveau)
• Saisie semi-automatique (nouvelle)

Remarque :Les détails sur un lieu (nouveau) sont disponibles dans le SDK Places pour Android version 3.3.0 et ultérieure. Pour en savoir plus, consultez Choisir votre version de SDK. Pour en savoir plus sur l'utilisation des API Kotlin ajoutées dans la version 4.0.0, consultez la présentation des références.

Requêtes Place Details (New)

Vous pouvez demander des informations sur un lieu en appelant PlacesClient.fetchPlace() et en transmettant un objet FetchPlaceRequest contenant un ID de lieu et une liste de champs, ainsi que des paramètres facultatifs:

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

Remarque:Pour en savoir plus sur l'initialisation de PlacesClient, consultez la section Initialiser le client de l'API Places.

Vous pouvez utiliser un CancellationToken pour tenter d'annuler une demande à l'une des classes de requêtes (par exemple, FetchPlaceRequest). L'annulation est effectuée de la manière la plus optimale possible. Une fois la demande d'annulation envoyée, aucune réponse ne sera renvoyée. L'émission d'un jeton d'annulation ne garantit PAS qu'une requête particulière sera annulée. Vous pouvez toujours être facturé pour la requête, même si aucune réponse n'est renvoyée.

Réponses Place Details (New)

Place Details (New) renvoie des données sous la forme d'un objet Place, qui n'inclut que les champs que vous avez demandés à l'aide de la liste de champs. Les résultats des données de lieu ne peuvent pas être vides. Par conséquent, seuls les résultats contenant des données sont renvoyés (par exemple, si un lieu demandé ne comporte pas de photos, le champ "photos" ne sera pas présent dans le résultat).

Pour accéder aux champs de données, appelez la méthode correspondante. Par exemple, pour accéder au nom du lieu, appelez getName().

Paramètres obligatoires

Les paramètres obligatoires pour FetchPlaceRequest sont les suivants:

• ID de lieu

  Identifiant textuel qui identifie un lieu de manière unique, renvoyé à partir d'une requête Text Search (New) (Recherche textuelle (nouvelle)), Nearby Search (New) (Recherche à proximité (nouvelle)) ou Autocomplete (New) (Saisie semi-automatique (nouvelle)). Pour en savoir plus sur les ID de lieu, consultez la présentation des ID de lieu.

• Liste des champs

  Lorsque vous demandez un lieu, vous devez spécifier les données de lieu à renvoyer. Pour ce faire, transmettez une liste de valeurs Place.Field spécifiant les données à renvoyer. Aucune liste par défaut des champs renvoyés n'est fournie dans la réponse.

  Les listes de champs sont une bonne pratique de conception pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés. Cette liste est un élément important, car elle affecte le coût de chaque requête. Pour en savoir plus, consultez la section Utilisation et facturation.

  Spécifiez un ou plusieurs des champs suivants:

  • Les champs suivants déclenchent le SKU Place Details Essentials IDs Only:

    Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
    
    Champs obsolètes

    • Le champ Place.Field.NAME a été abandonné dans la version 4.0 du SDK Places pour Android. Utilisez plutôt Place.Field.DISPLAY_NAME.
    • Le champ RESOURCE_NAME contient le nom de la ressource de lieu au format places/PLACE_ID. Utilisez DISPLAY_NAME pour accéder au nom textuel du lieu.

  • Les champs suivants déclenchent le SKU Place Details Essentials:

    Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS
Place.Field.LOCATION
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT
    
    Champs obsolètes:les champs Place.Field.ADDRESS et Place.Field.LAT_LNG ont été abandonnés dans la version 4.0 du SDK Places pour Android. Utilisez plutôt Place.Field.FORMATTED_ADDRESS et Place.Field.LOCATION, respectivement.

  • Les champs suivants déclenchent le SKU Place Details Pro:

    Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.BUSINESS_STATUS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET
    
    Champs obsolètes:les champs Place.Field.ICON_URL et Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE ont été abandonnés dans la version 4.0 du SDK Places pour Android. Utilisez plutôt Place.Field.ICON_MASK_URL et Place.Field.ACCESSIBILITY_OPTIONS, respectivement. Place.Field.ACCESSIBILITY_OPTIONS n'est disponible que pour "Détails sur un lieu (nouveau)".

  • Les champs suivants déclenchent le SKU Place Details Enterprise:

    Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
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
Place.Field.WEBSITE_URI
    
    Champs obsolètes:les champs Place.Field.PHONE_NUMBER et Place.Field.USER_RATINGS_TOTAL ont été abandonnés dans la version 4.0 du SDK Places pour Android. Utilisez plutôt Place.Field.INTERNATIONAL_PHONE_NUMBER et Place.USER_RATING_COUNT, respectivement.

  • Les champs suivants déclenchent le SKU Place Details Enterprise Plus:

    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
  Remarque:La version 4.0 du SDK Places pour Android a vu l'abandon de plusieurs champs de données de lieu et l'ajout de nouveaux champs. Pour en savoir plus, consultez Migrer vers les nouveaux champs de données de lieu dans le SDK Places pour Android 4.0 .

Paramètres facultatifs

Les paramètres facultatifs pour FetchPlaceRequest sont les suivants:

• Code régional

  Code de région utilisé pour mettre en forme la réponse, spécifié sous la forme d'une valeur de code CLDR à deux caractères. Il n'existe pas de valeur par défaut.

  Si le nom du pays du champ Place.Field.FORMATTED_ADDRESS de la réponse correspond à regionCode, le code pays est omis de Place.Field.FORMATTED_ADDRESS.

  La plupart des codes CLDR sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable.

  Pour définir le paramètre de code de région, appelez la méthode setRegionCode() lors de la création de l'objet FetchPlaceRequest.

• Jeton de session

  Les jetons de session sont des chaînes générées par l'utilisateur qui suivent les appels de saisie semi-automatique (nouveau) en tant que "sessions". Autocomplete (New) utilise des jetons de session pour regrouper les phases de requête et de sélection de lieu d'une recherche de saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation. Les jetons de session sont transmis aux appels Place Details (New) qui suivent les appels Autocomplete (New). Pour en savoir plus, consultez la section Jetons de session.

  Pour définir le paramètre de jeton de session, appelez la méthode setSessionToken() lors de la création de l'objet FetchPlaceRequest.

Exemple de requête Place Details

L'exemple suivant demande les champs ID, DISPLAY_NAME et FORMATTED_ADDRESS pour l'Empire State Building à New York.

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