Cette page a été traduite par l'API Cloud Translation.

Lien vers Google Maps

L'API Places accepte les requêtes de données sur les lieux via diverses méthodes. La réponse de l'API Places contient des données sur un lieu, y compris des données de localisation et des images, des emplacements géographiques et des points d'intérêt importants.

Avec cette version, la réponse de Text Search, Nearby Search et Place Details peut également contenir des liens vers Google Maps. Vos utilisateurs peuvent accéder à ces liens Google Maps pour obtenir des informations supplémentaires sur un lieu dans la réponse.

Par exemple, vous recherchez des aéroports à San Francisco, en Californie. La réponse inclut ensuite l'aéroport international de San Francisco (SFO) dans la liste des lieux. Avec cette version, l'objet Place pour SFO dans la réponse ajoute le champ googleMapsUri contenant des liens Google Maps pour ouvrir Google Maps vers le lieu, les itinéraires vers le lieu, les avis sur le lieu et les photos du lieu.

En plus des liens ajoutés à l'objet Place, cette version ajoute également le champ googleMapsUri aux objets Reviews et Photos dans la réponse:

Reviews.googleMapsUri: contient un lien Google Maps vers l'avis afin que vous puissiez le consulter dans un navigateur.
Photos.googleMapsUri: contient un lien Google Maps vers la photo pour que vous puissiez l'afficher dans un navigateur.

API Explorer vous permet d'envoyer des requêtes en direct afin de vous familiariser avec ces nouvelles options:

Essayer

Liens Google Maps compatibles pour un lieu

Le tableau suivant présente les liens Google Maps que vous pouvez inclure dans la réponse:

Lien Google Maps	Description	Nom du champ
Lieu	Lien permettant d'ouvrir Google Maps pour accéder à l'établissement.	`googleMapsLinks.placeUri`
Instructions	Lien permettant d'ouvrir l'itinéraire vers le lieu dans Google Maps.	`googleMapsLinks.directionsUri`
Rédiger un avis	Lien permettant de rédiger un avis sur le lieu dans Google Maps.	`googleMapsLinks.writeAReviewUri`
Lire des avis	Lien permettant d'afficher les avis Google Maps sur le lieu	`googleMapsLinks.reviewsUri`
Photos	Lien permettant d'afficher des photos de l'établissement dans Google Maps.	`googleMapsLinks.photosUri`

Tarifs

Cette fonctionnalité est en phase de pré-disponibilité générale et son utilisation est sans frais pendant la phase de preview (facturation de 0 $). Pour en savoir plus sur les tarifs proposés, consultez la page Utilisation et facturation de l'API Places.

Inclure tous les liens dans la réponse Places

Les liens de la réponse des lieux sont contenus dans le champ googleMapsLinks. Assurez-vous d'inclure le champ googleMapsLinks dans le masque de champ de la requête si vous souhaitez qu'il apparaisse dans la réponse.

Par exemple, la recherche textuelle suivante inclut tous les liens Maps dans la réponse:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Inclure un lien spécifique dans la réponse

Vous n'êtes pas obligé de renvoyer tous les liens dans la réponse. Par exemple, si vous ne souhaitez inclure que le lien vers les photos dans la réponse, modifiez le masque de champ comme indiqué ci-dessous pour n'inclure que le champ photosUri:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Inclure des instructions dans la réponse

Toutes les méthodes Places permettent de générer le lien vers les itinéraires dans la réponse. La position actuelle est utilisée comme point de départ, l'emplacement de l'établissement est utilisé comme destination et le mode de transport est "En voiture".

L'exemple suivant utilise la recherche dans les environs pour inclure le lien vers les itinéraires Maps dans la réponse dans le champ directionsUri:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Incluez des liens vers des avis et des photos

Cette version ajoute le champ googleMapsUri aux objets Reviews et Photos de la réponse. L'accès à ces liens ouvre l'avis ou la photo dans Google Maps.

Par exemple, la recherche textuelle suivante inclut des avis et des photos pour chaque lieu dans la réponse:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

Dans la réponse, chaque élément du tableau des avis et des photos contient le champ googleMapsUri pour ouvrir l'avis ou la photo dans un navigateur.

Essayer

API Explorer vous permet d'envoyer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

Sélectionnez l'icône API sur le côté droit de la page.
Vous pouvez également développer Afficher les paramètres standards et définir le paramètre fields sur le masque de champ.
Modifiez éventuellement le corps de la requête.
Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour effectuer la demande.
Dans le panneau API Explorer, sélectionnez l'icône de développement, , pour développer la fenêtre API Explorer.