Place Details (nouveau)

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

Vous pouvez demander plus de détails sur un établissement ou un point d'intérêt particulier en utilisant son ID de lieu et en effectuant une requête Place Details (New). Place Details (New) affiche des informations plus complètes sur le lieu indiqué, telles que son adresse complète, son numéro de téléphone, les notes et les avis des visiteurs.

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

• Text Search (nouvelle version)
• Nearby Search (nouveau)
• Saisie semi-automatique (nouveauté)

Remarque :Place Details (New) est disponible dans le SDK Places pour Android 3.3.0 et versions ultérieures. Pour en savoir plus, consultez Choisir la version de votre SDK.

Requêtes Place Details (New)

Pour demander des détails sur un lieu, appelez PlacesClient.fetchPlace() et transmettez 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);

Vous pouvez utiliser un CancellationToken pour tenter d'annuler une requête adressée à l'une des classes de requête (par exemple, FetchPlaceRequest). L'annulation est effectuée dans la mesure du possible. Lorsqu'une demande d'annulation est envoyée, aucune réponse n'est renvoyée. L'émission d'un jeton d'annulation ne garantit PAS l'annulation d'une requête particulière, et peut vous être facturée 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 de données de lieu ne peuvent pas être vides. Par conséquent, seuls les résultats contenant des données de lieu sont renvoyés (par exemple, si un lieu demandé ne comporte aucune photo, le champ "photos" n'apparaîtra pas 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 requis pour FetchPlaceRequest sont les suivants:

• ID de lieu

  Identifiant textuel qui identifie un lieu de manière unique, renvoyé par une requête Text Search (nouvelle), Nearby Search (nouvelle) ou Autocomplete (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. La réponse ne contient pas de liste par défaut des champs renvoyés.

  Les listes de champs sont une bonne pratique à suivre pour vous assurer de ne pas demander de données inutiles, ce qui permet d'éviter des délais de traitement et des frais facturés inutiles.Cette liste est importante, car elle affecte le coût de chaque requête. Pour en savoir plus, consultez la page Utilisation et facturation.

  Renseignez un ou plusieurs des champs suivants:

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

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

  • Les champs suivants déclenchent le SKU Place Details (Location Only):

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

  • Les champs suivants déclenchent le SKU Place Details (Basic):

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

  • Les champs suivants déclenchent le SKU Place Details (Advanced):

    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

  • Les champs suivants déclenchent le SKU Place Details (Preferred):

    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

Paramètres facultatifs

Les paramètres facultatifs pour FetchPlaceRequest sont les suivants:

• Code régional

  Code régional 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 de pays du champ Place.Field.ADDRESS dans la réponse correspond à regionCode, le code pays est omis de Place.Field.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"). Ce paramètre peut avoir un impact sur les résultats en fonction du droit applicable.

  Pour définir le paramètre de code régional, 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 la saisie semi-automatique (nouveau) comme des "sessions". Autocomplete (nouveau) utilise des jetons de session pour regrouper les phases de requête et de sélection de lieux d'une recherche avec saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation. Les jetons de session sont transmis dans les 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 Place Details

L'exemple suivant demande les champs ID, NAME et 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.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);