Identifiants de lieu

Les identifiants de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps.

  1. Présentation
  2. Extraire les détails de lieu à l'aide de l'identifiant de lieu
  3. Gérer plusieurs identifiants de lieu et leur validité
  4. Rechercher l'identifiant d'un lieu spécifique
  5. Enregistrer les identifiants de lieu pour une utilisation ultérieure

Rechercher l'identifiant d'un lieu spécifique

Vous recherchez l'identifiant de lieu d'un lieu spécifique ? Utilisez l'outil de recherche d'identifiants de lieu ci-dessous pour rechercher un lieu et son identifiant :

Vous pouvez aussi consulter l'outil de recherche d'identifiants de lieu et son code dans la documentation Google Maps JavaScript API.

Présentation

Un identifiant de lieu est un identifiant texte qui identifie un lieu de façon unique. Il se présente comme dans l'exemple suivant (la longueur de l'identifiant peut varier) :

ChIJrTLr-GyuEmsRBfy61i59si0

Des identifiants de lieu sont disponibles pour la plupart des points géographiques, y compris les entreprises, points de repère, parcs et intersections. Ces identifiants sont fixes, c'est-à-dire qu'une fois l'identifiant déterminé pour un lieu, vous pouvez réutiliser cette valeur lorsque vous recherchez ce lieu.

Vous pouvez utiliser le même identifiant de lieu sur toutes les Google Places API et sur plusieurs Google Maps API. Par exemple, vous pouvez utiliser le même identifiant de lieu pour référencer un lieu sur Places API, Google Maps JavaScript API, Google Maps Geocoding API, Google Maps Embed API et Google Maps Roads API.

Extraire les détails de lieu à l'aide de l'identifiant de lieu

L'identifiant de lieu offre un moyen fiable de référencer des informations sur un lieu en particulier. Les identifiants de lieu sont couramment utilisés pour rechercher un lieu (à l'aide de Google Places API Web Serviceou de la bibliothèque Places dans Google Maps JavaScript API, par exemple). L'identifiant de lieu renvoyé permet ensuite d'extraire des détails sur le lieu. Vous pouvez stocker l'identifiant de lieu et l'utiliser pour extraire des détails sur ce même lieu ultérieurement.

Exemple d'utilisation de la bibliothèque Places dans Google Maps JavaScript API

Pour utiliser un identifiant de lieu dans votre application JavaScript, vous devez d'abord rechercher cet identifiant, disponible dans l'objet PlaceResult renvoyé par une recherche de lieux Place Search, ou par la méthode getPlace() dans le service Place Autocomplete. Vous pouvez ensuite utiliser cet identifiant de lieu pour rechercher des détails sur le lieu.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

Gérer plusieurs identifiants de lieu et leur validité

Chaque identifiant de lieu fait référence à un lieu unique, mais un lieu peut avoir plusieurs identifiants. Le cas le plus courant est lorsque vous ajoutez un lieu initialement valable pour votre application et que ce lieu devient valable pour toutes les applications Google.

Lorsque vous ajoutez un lieu en utilisant Places API Web Service, vous recevez immédiatement un identifiant pour ce lieu. Cet identifiant de lieu est valable pour votre application uniquement. Le lieu est ensuite placé dans une file d'attente de modération pour déterminer s'il peut être intégré à la base de données Google Places. S'il est approuvé, le lieu reçoit un nouvel identifiant, valable pour toutes les applications et sur Google Maps. Pour plus de détails, voir la documentation sur l'ajout de lieux.

Un lieu peut être associé à un nouvel identifiant de lieu dans d'autres cas. Par exemple, lorsqu'un professionnel déménage.

Le schéma suivant illustre un scénario possible dans lequel un lieu peut avoir plusieurs identifiants de lieu :

Extraire un lieu possédant plusieurs identifiants

Lorsqu'un lieu a plusieurs identifiants, cela n'affecte aucunement les requêtes Places API. Toutefois, cela affecte la réponse.

Lorsque vous recherchez un lieu par identifiant de lieu, vous êtes assuré de toujours recevoir le même lieu en réponse (s'il existe toujours).

Toutefois, la réponse peut contenir plusieurs identifiants pour le lieu demandé ou un identifiant de lieu différent de celui indiqué dans votre requête.

  • Comportement dans Places API Web Service : Si le lieu a plusieurs identifiants, Places API Web Service renvoie l'identifiant principal de ce lieu, ainsi qu'un tableau contenant tous ses autres identifiants. Voir la documentation sur les détails de lieu et la recherche de lieux.
  • Comportement dans la bibliothèque JavaScript Places et autres API : Lorsque vous demandez des détails de lieu pour un identifiant de lieu spécifique, vous recevez les détails pour le lieu demandé. Notez toutefois que l'identifiant de lieu peut différer si le lieu a reçu un nouvel identifiant depuis votre dernière demande. Vous pouvez continuer à utiliser l'identifiant de lieu d'origine sans problème pour accéder au lieu, mais il est recommandé de le remplacer par l'identifiant de lieu le plus récent dès que possible.

Enregistrer les identifiants de lieu pour une utilisation ultérieure

Les identifiants de lieu ne sont pas concernés par les restrictions de mise en cache stipulées dans la Section 10.5.d des Conditions de service de Google Maps API. Vous pouvez de ce fait stocker autant d'identifiants de lieu que souhaité.

Envoyer des commentaires concernant…