Place Details (nouveau)

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

Vous pouvez demander plus de détails sur un établissement ou un point de d'intérêt en utilisant sa position ID et à créer un requête Place Details (New). Place Details (New) renvoie des informations plus complètes des informations sur le lieu indiqué, telles que son adresse complète, son numéro de la note et les avis des visiteurs.

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

Requêtes Place Details (New)

Vous pouvez demander des informations sur le lieu en appelant PlacesClient.fetchPlace() et en transmettant FetchPlaceRequest contenant un identifiant de lieu et une liste de champs, ainsi que comme n'importe quel paramètre facultatif:

// 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);
<ph type="x-smartling-placeholder">

Réponses Place Details (New)

Place Details (New) renvoie des données sous la forme d'un Place , qui inclut uniquement les champs demandés à l'aide de la propriété liste. Les résultats des données de lieu ne peuvent pas être vides : seuls les résultats de lieu sont disponibles. contenant des données sont renvoyées. Par exemple, si le lieu demandé ne comporte aucune photo, le photos ne sera pas présent dans le résultat).

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

Paramètres obligatoires

Les paramètres requis pour FetchPlaceRequest sont:

Paramètres facultatifs

Les paramètres facultatifs pour FetchPlaceRequest sont:

  • Code régional

    Code régional utilisé pour mettre en forme la réponse, spécifié sous la forme d'une 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 au 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 au Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb". (d'un point de vue technique, du Royaume-Uni de Grande-Bretagne et d'Irlande du Nord). Ce paramètre peut avoir un impact sur les résultats en fonction de la législation 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 La saisie semi-automatique (nouvelle version) appelle les "sessions". La saisie semi-automatique (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 à Place Details (nouveau) qui suivent les appels de saisie semi-automatique (nouveau). Pour en savoir plus, consultez 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 le 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);