Place Details (nouveau)

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

Une fois que vous disposez d'un ID de lieu, vous pouvez demander plus de détails sur un établissement ou point d'intérêt en lançant une Place Details (nouveau) requête. A Place Details (nouveau) renvoie des informations plus complètes sur le lieu indiqué. comme l'adresse complète, le 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 utiliser :

APIs Explorer vous permet d'effectuer des requêtes en direct afin que vous puissiez vous familiariser avec l'API et la Options d'API:

Essayer

Requêtes Place Details (New)

Une requête Places Details est une requête HTTP GET au format suivant:

https://places.googleapis.com/v1/places/PLACE_ID

Transmettez tous les paramètres en tant que paramètres d'URL ou dans les en-têtes dans le cadre de la méthode GET. Exemple :

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Ou dans une commande cURL:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Réponses Place Details (New)

Place Details (New) renvoie une JSON comme réponse. Dans la réponse :

  • La réponse est représentée par Place . L'objet Place contient des informations détaillées sur le à un emplacement.
  • Le champ FieldMask transmis dans la requête spécifie la liste des champs. renvoyées dans l'objet Place.

L'objet JSON complet se présente sous la forme suivante:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Paramètres obligatoires

  • FieldMask

    Spécifiez la liste des champs à renvoyer dans la réponse en créant un masque de champ de réponse. Transmettre le masque de champ de réponse à la méthode à l'aide du paramètre d'URL $fields ou fields, ou à l'aide de l'en-tête HTTP X-Goog-FieldMask Il n'existe pas de liste par défaut des champs renvoyés dans la réponse. Si vous omettez le masque de champ, la méthode renvoie une erreur.

    Le masquage du champ est une bonne pratique de conception pour vous assurer que vous ne demandez pas des données inutiles, ce qui permet d'éviter les délais de traitement et frais facturés.

    Spécifiez une liste de types de données de lieu à renvoyer, séparés par une virgule. Par exemple : pour récupérer le nom à afficher et l'adresse du lieu.

    X-Goog-FieldMask: displayName,formattedAddress

    Utilisez * pour récupérer tous les champs.

    X-Goog-FieldMask: *

    Renseignez un ou plusieurs des champs suivants:

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

      attributions, id, name*, photos

      * Le champ name contient le nom de ressource du lieu. au format suivant: places/PLACE_ID. Utilisez displayName pour accéder au nom textuel du lieu.

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

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

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

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

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

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

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

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout
      .

  • placeId

    Identifiant textuel qui identifie un lieu de façon unique, renvoyé par une Text Search (nouvelle version) ou Nearby Search (nouveau) : Pour en savoir plus sur les ID de lieu, consultez les présentation des ID de lieu.

    La chaîne places/PLACE_ID est également appelée le lieu nom de ressource. Dans la réponse d'une requête Place Details (New), Nearby Search (nouvelle version) et Text Search (nouvelle version) requête, cette chaîne est contenue dans le champ name de la réponse. Version autonome l'ID de lieu est contenu dans le champ id de la réponse.

Paramètres facultatifs

  • languageCode

    Langue dans laquelle les résultats doivent être renvoyés.

    • Consultez le liste des langues acceptées Google met souvent à jour les langages pris en charge, cette liste n'est donc peut-être pas exhaustive.
    • Si languageCode n'est pas fourni, l'API est définie par défaut sur en. Si si vous spécifiez un code de langue non valide, l'API renvoie une erreur INVALID_ARGUMENT.
    • L'API s'efforce de fournir une adresse postale lisible par à la fois l’utilisateur et les locaux. Pour atteindre cet objectif, la fonction dans la langue locale, transcrites en un script lisible par l'utilisateur si nécessaire, en tenant compte de la langue préférée. Toutes les autres sont renvoyées dans la langue de votre choix. Les composants d'adresse sont tous renvoyés dans la même langue, celle choisie .
    • Si un nom n'est pas disponible dans la langue préférée, l'API utilise le la correspondance la plus proche.
    • La langue préférée a une petite influence sur l'ensemble des résultats l'API choisit de les renvoyer, ainsi que l'ordre dans lequel ils sont renvoyés. La le geocoder interprète les abréviations différemment selon la langue, comme les abréviations de types de rues ou des synonymes est valide dans une langue, mais pas dans une autre.
  • regionCode

    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 formattedAddress dans la réponse correspond au regionCode, le code pays est omis de formattedAddress. Ce paramètre n'a aucun effet sur adrFormatAddress, qui inclut toujours le pays ou sur shortFormattedAddress, qui ne l'inclut jamais.

    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.

  • sessionToken

    Les jetons de session sont des chaînes générées par l'utilisateur qui suivent la saisie semi-automatique (Nouveau) les appels en tant que "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 :

Exemple Place Details

L'exemple suivant demande les détails d'un lieu en placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Notez que l'en-tête X-Goog-FieldMask indique que réponse contient les champs de données suivants: id,displayName. La réponse se présente alors sous la forme suivante:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Ajoutez d'autres types de données au masque de champ pour renvoyer des informations supplémentaires. Par exemple, ajoutez formattedAddress,plusCode pour inclure le et le Plus Code dans le réponse:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

La réponse se présente désormais sous la forme suivante:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Essayer

APIs Explorer vous permet de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

Pour envoyer une demande:

  1. Sélectionnez l'icône API Développez APIs Explorer., sur le côté droit de la page.
  2. Vous pouvez également définir le paramètre name sur:
    places/PLACE_ID
  3. Vous pouvez également développer Afficher les paramètres standards et définir Le paramètre fields au masque de champ.
  4. Sélectionnez le bouton Execute (Exécuter). Dans la fenêtre pop-up, sélectionnez le compte utiliser pour effectuer la requête.
  5. Dans le panneau APIs Explorer, sélectionnez l'icône de développement, Développez APIs Explorer., pour développer la fenêtre de l'explorateur d'API.