Lien vers Google Maps

L'API Places (New) accepte les requêtes de données de lieu via différentes méthodes. La réponse de l'API Places (New) 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.

La réponse de la recherche textuelle (New), de la recherche à proximité (New) et des détails sur le lieu (New) peut également contenir des liens vers Google Maps. Vos utilisateurs peuvent accéder à ces liens Google Maps pour afficher 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. L'objet Place pour SFO dans la réponse ajoute le champ googleMapsUri contenant des liens Google Maps pour ouvrir Google Maps à l'endroit, les itinéraires vers l'endroit, les avis sur l'endroit et les photos de l'endroit.

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

• Reviews.googleMapsUri: contient un lien Google Maps vers l'avis afin que vous puissiez l'afficher dans un navigateur.

• Photos.googleMapsUri: contient un lien Google Maps vers la photo afin que vous puissiez l'afficher dans un navigateur.

L'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 :

Inclure tous les liens dans la réponse Places

Les liens de la réponse Places sont contenus dans le googleMapsLinks champ. Veillez à inclure le champ googleMapsLinks dans le masque de champ de la requête si vous souhaitez qu'ils apparaissent dans la réponse.

Par exemple, la recherche textuelle (New) 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 comme suit :

{
  "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 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 itinéraires dans la réponse

Toutes les méthodes Places sont compatibles avec la génération du lien d'itinéraire dans la réponse. L'emplacement actuel est utilisé comme origine, l'emplacement du lieu comme destination et le mode de transport comme voiture.

L'exemple suivant utilise la recherche à proximité (New) pour inclure le lien d'itinéraire 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

Inclure des liens vers les avis et les photos

Cette version ajoute le googleMapsUri champ aux Reviews et Photos objets dans la réponse. En accédant à ces liens, vous ouvrez l'avis ou la photo dans Google Maps.

Par exemple, la recherche textuelle (New) suivante inclut les avis et les photos de 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 permettant d'ouvrir l'avis ou la photo dans un navigateur.

Essayer

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

1. Sélectionnez l'icône d'API api à droite de la page.

2. Vous pouvez également développer Afficher les paramètres standards et définir le fields paramètre sur le masque de champ.

3. Vous pouvez également modifier le corps de la requête.

4. Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour envoyer la requête.

5. Dans le panneau de l'API Explorer, sélectionnez fullscreen

   Plein écran pour développer la fenêtre de l'API Explorer.