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 :
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);
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 dePlace.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'objetFetchPlaceRequest
.-
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'objetFetchPlaceRequest
.
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);