Lien vers Google Maps

L'API Places (New) accepte les requêtes de données de lieux via différentes méthodes. La réponse de l'API Places (nouveau) 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 Text Search (New), Nearby Search (New) et Place Details (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 sur 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, le champ googleMapsUri est également ajouté aux objets Reviews et Photos dans la réponse :

• Reviews.googleMapsUri : contient un lien Google Maps vers l'avis pour que vous puissiez le consulter dans un navigateur.

• Photos.googleMapsUri : contient un lien Google Maps vers la photo pour que vous puissiez la consulter dans un navigateur.

L'API Explorer vous permet d'envoyer des requêtes en temps réel pour vous familiariser avec ces nouvelles options :

Essayer

Liens Google Maps acceptés 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 dans la réponse sur les lieux sont contenus dans le champ googleMapsLinks. Veillez à 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 de texte (nouveau) 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'avez pas besoin 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 instructions dans la réponse

Toutes les méthodes Places sont compatibles avec la génération du lien vers l'itinéraire dans la réponse. La position actuelle est utilisée comme point de départ, le lieu comme destination et le mode de déplacement comme "en voiture".

L'exemple suivant utilise Nearby Search (New) pour inclure le lien vers l'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 champ googleMapsUri aux objets Reviews et Photos de la réponse. Si vous accédez à ces liens, l'avis ou la photo s'ouvrent dans Google Maps.

Par exemple, la recherche de texte (nouveau) suivante inclut des avis et des photos pour chaque lieu de 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 "reviews" et "photos" contient le champ googleMapsUri permettant d'ouvrir l'avis ou la photo dans un navigateur.

Essayer

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

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

2. Vous pouvez également développer Afficher les paramètres standards et définir le paramètre fields 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 demande.

5. Dans le panneau "API Explorer", sélectionnez fullscreen .

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