Lien vers Google Maps

L'API Places (nouveau) 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.

  Remarque : Pour un lieu donné, le champ ReviewSummary.reviewsUri de l'objet ReviewSummary contient le même lien que le champ Reviews.googleMapsUri.

• 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 :

Lien Google Maps	Description	Nom du champ
Lieu	Lien permettant d'ouvrir le lieu dans Google Maps.	googleMapsLinks.placeUri
Itinéraire	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 du lieu dans Google Maps.	googleMapsLinks.photosUri

Inclure tous les liens dans la réponse Places

Les liens dans la réponse des 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'ils apparaissent 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"
      }
    }
  ]
}

Remarque : Auparavant, l'objet Place de la réponse incluait le champ place.googleMapsURI contenant un lien Google Maps vers le lieu. Le nouveau champ place.googleMapsLinks.placeURI de la réponse contient la même valeur que place.googleMapsURI.

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 d'itinéraire dans la réponse. La position actuelle est utilisée comme point de départ, l'emplacement du lieu comme destination et le mode de déplacement comme "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

Remarque : Pour Text Search (New) et Nearby Search (New), vous pouvez utiliser le paramètre de requête routingParameters pour spécifier une origine explicite (facultatif). Bien que ce paramètre de requête affecte les résumés d'itinéraire et la recherche le long de l'itinéraire dans la réponse, les itinéraires Google Maps sont toujours calculés à partir de la position actuelle.

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 requête Text Search (New) 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 des avis et des photos contient le champ googleMapsUri permettant d'ouvrir l'avis ou la photo dans un navigateur.

Essayer

L'explorateur d'API vous permet d'effectuer des exemples de requêtes pour vous familiariser avec l'API et ses options.

1. Sélectionnez l'icône d'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 éventuellement 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 .

   Plein écran pour agrandir la fenêtre APIs Explorer.