Places Service

Classe PlacesService

Classe google.maps.places.PlacesService

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

Accédez-y en appelant le const {PlacesService} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlacesService
PlacesService(attrContainer)
Paramètres :
Crée une instance de PlacesService qui affiche les attributions dans le conteneur spécifié.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Paramètres :
Valeur renvoyée : aucune
Récupère une liste de lieux à partir d'un numéro de téléphone. Dans la plupart des cas, la liste de résultats ne doit contenir qu'un seul élément. Toutefois, si la demande est ambiguë, plusieurs résultats peuvent être renvoyés. Les PlaceResult transmis au rappel sont des sous-ensembles d'un PlaceResult complet. Votre application peut obtenir un PlaceResult plus détaillé pour chaque lieu en appelant PlacesService.getDetails et en transmettant le PlaceResult.place_id du lieu souhaité.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Paramètres :
Valeur renvoyée : aucune
Récupère une liste de lieux en fonction d'une chaîne de requête. Dans la plupart des cas, la liste de résultats ne doit contenir qu'un seul élément. Toutefois, si la demande est ambiguë, plusieurs résultats peuvent être renvoyés. Les PlaceResult transmis au rappel sont des sous-ensembles d'un PlaceResult complet. Votre application peut obtenir un PlaceResult plus détaillé pour chaque lieu en appelant PlacesService.getDetails et en transmettant le PlaceResult.place_id du lieu souhaité.
getDetails
getDetails(request, callback)
Paramètres :
Valeur renvoyée : aucune
Récupère des informations sur le lieu identifié par le placeId donné.
nearbySearch
nearbySearch(request, callback)
Paramètres :
Valeur renvoyée : aucune
Récupère une liste de lieux à proximité d'un emplacement spécifique, en fonction d'un mot clé ou d'un type. L'emplacement doit toujours être spécifié, soit en transmettant un paramètre LatLngBounds, soit en transmettant les paramètres location et radius. Les PlaceResult transmis au rappel sont des sous-ensembles du PlaceResult complet. Votre application peut obtenir un PlaceResult plus détaillé pour chaque lieu en envoyant une requête Place Details et en transmettant le PlaceResult.place_id du lieu souhaité. L'objet PlaceSearchPagination peut être utilisé pour récupérer des pages de résultats supplémentaires (la valeur est "null" s'il s'agit de la dernière page de résultats ou s'il n'y a qu'une seule page de résultats).
textSearch
textSearch(request, callback)
Paramètres :
Valeur renvoyée : aucune
Récupère une liste de lieux en fonction d'une chaîne de requête (par exemple, "pizza à New York" ou "magasins de chaussures près d'Ottawa"). Les paramètres de localisation sont facultatifs. Lorsque la localisation est spécifiée, les résultats sont uniquement orientés vers les résultats à proximité, et non limités aux lieux situés dans la zone. Utilisez textSearch lorsque vous souhaitez rechercher des lieux à l'aide d'une chaîne arbitraire et dans les cas où vous ne souhaitez pas limiter les résultats de recherche à un lieu spécifique. L'objet PlaceSearchPagination peut être utilisé pour récupérer des pages de résultats supplémentaires (la valeur est "null" s'il s'agit de la dernière page de résultats ou s'il n'y a qu'une seule page de résultats).

Interface PlaceDetailsRequest

Interface google.maps.places.PlaceDetailsRequest

Requête Place Details à envoyer à PlacesService.
placeId
Type : string
ID du lieu pour lequel des détails sont demandés.
fields optional
Type : Array<string> optional
Champs à inclure dans la réponse détaillée, qui seront facturés. Si aucun champ n'est spécifié ou si ['ALL'] est transmis, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez PlaceResult. Les champs imbriqués peuvent être spécifiés avec des chemins d'accès (par exemple, "geometry.location").
language optional
Type : string optional
Identifiant de la langue dans laquelle les détails doivent être renvoyés. Consultez la liste des langues disponibles.
region optional
Type : string optional
Code de région de l'utilisateur. Cela peut avoir une incidence sur les photos qui peuvent être renvoyées, et peut-être sur d'autres éléments. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
sessionToken optional
Type : AutocompleteSessionToken optional
Référence unique utilisée pour regrouper la requête de détails avec une session Autocomplete.

Interface FindPlaceFromPhoneNumberRequest

Interface google.maps.places.FindPlaceFromPhoneNumberRequest

Requête Find Place à partir d'une recherche textuelle à envoyer à PlacesService.findPlaceFromPhoneNumber.
fields
Type : Array<string>
Champs à inclure dans la réponse, qui seront facturés. Si ['ALL'] est transmis, tous les champs disponibles seront renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez PlaceResult. Les champs imbriqués peuvent être spécifiés avec des chemins d'accès (par exemple, "geometry.location").