places.PlacesService

Référence API Google Maps JavaScript version 3.24

API Google Maps JavaScript version 3

Partager ce tutoriel sur les réseaux sociaux
Signaler une erreur dans cet article

Classe PlacesService

classe google.maps.places.PlacesService

Contient des méthodes liées à la recherche de lieux et à la récupération des informations sur un lieu.

Bibliothèque

places

Constructeur
Méthode
Constructeur places.PlacesService
ConstructeurDescription
PlacesService(
       attrContainer:HTMLDivElement|Map
)

Crée une nouvelle instance du service Places places.PlacesService que les attributions rendent dans le conteneur spécifié.

Méthode places.PlacesService
MéthodeValeur RetournéeDescription
getDetails(
     request:places.PlaceDetailsRequest,
     callback:function(
          places.PlaceResult,
          places.PlacesServiceStatus
     )
)
Valeur retournée :  None 

Récupère les détails sur le lieux identifié par la référence donnée.

nearbySearch(
     request:places.PlaceSearchRequest,
     callback:function(
           Array .<places.PlaceResult>,
          places.PlacesServiceStatus,
          places.PlaceSearchPagination
     )
)
Valeur retournée :  None 

Récupère une liste de lieux dans une zone donnée.

Les résultats places.PlaceResult passés à la fonction de rappel sont une version allégée d'un PlaceResult intégral.

Un résultat places.PlaceResult plus détaillé pour chaque lieu peut être obtenu en envoyant une requête places.PlaceDetailsRequest avec la valeur reference du lieu désiré.

radarSearch(
     request:places.RadarSearchRequest,
      callback:function(
           Array <places.PlaceResult>,
          places.PlacesServiceStatus
     )
)
Valeur retournée :  None 

Similaire à la fonction nearbySearch, avec les différences suivantes: la réponse de recherche comprendra jusqu'à 200 lieux, identifiés uniquement par leur coordonnées géographiques et la référence du lieu.

Attention: reference est obsolète et a été templacé par placeId.

textSearch(
     request:places.TextSearchRequest,
     callback:function(
           Array .<places.PlaceResult>,
          places.PlacesServiceStatus
     )
)
Valeur retournée :  None 

Similaire à la méthode nearbySearch, avec les différences suivantes :

  • il récupère une liste de lieux basée sur l'attribut query dans l'objet requête transmis;
  • les paramètres bounds ou location + radius sont facultatifs;
  • la région, lorsqu'elle est fournie, ne restreint pas le résultat aux lieux présents dans la zone, elle influence la réponse vers les résultats situés à proximité d'elle.