Places Widgets

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe Autocomplete

Classe google.maps.places.Autocomplete

Widget fournissant des prédictions de lieu basées sur le texte saisi par l'utilisateur. Il s'associe à un élément d'entrée de type text et écoute l'entrée de texte dans ce champ. La liste des prédictions s'affiche sous la forme d'une liste déroulante. Elle est mise à jour au fur et à mesure que vous saisissez du texte.

Cette classe étend MVCObject.

Nécessite le paramètre d'URL &libraries=places. Consultez la section Bibliothèques dans l'API Maps JavaScript.

Autocomplete
Autocomplete(inputField[, opts])
Paramètres :
Crée une instance de Autocomplete qui s'associe au champ de saisie spécifié avec les options données.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée : LatLngBounds|undefined limites de pondération.
Renvoie les limites auxquelles les prédictions sont biaisées.
getFields
getFields()
Paramètres:aucun
Valeur renvoyée : Array<string>|undefined
Renvoie les champs à inclure pour le lieu dans la réponse détaillée une fois les détails récupérés. Pour obtenir la liste des champs, consultez PlaceResult.
getPlace
getPlace()
Paramètres : aucun
Valeur renvoyée : PlaceResult lieu sélectionné par l'utilisateur.
Renvoie les détails du lieu sélectionné par l'utilisateur si ceux-ci ont été correctement récupérés. Sinon, renvoie un objet bouchon, avec la propriété name définie sur la valeur actuelle du champ de saisie.
setBounds
setBounds(bounds)
Paramètres:
Valeur renvoyée : aucune
Définit la zone à privilégier pour le renvoi des résultats du lieu. Les résultats sont orientés vers cette zone, sans s'y limiter.
setComponentRestrictions
setComponentRestrictions(restrictions)
Paramètres:
Valeur renvoyée : aucune
Définit les restrictions applicables aux composants. Les restrictions des composants permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
setFields
setFields(fields)
Paramètres :
  • fields : Array<string> optional
Valeur renvoyée:aucune
Définit les champs à inclure pour le lieu dans la réponse détaillée lorsque les détails sont récupérés. Pour obtenir la liste des champs, consultez PlaceResult.
setOptions
setOptions(options)
Paramètres :
Valeur renvoyée : aucune
setTypes
setTypes(types)
Paramètres:
  • typesArray<string> optional types de prédictions à inclure.
Valeur renvoyée : aucune
Définit les types de prédictions à afficher. Pour connaître les types compatibles, consultez le guide du développeur. Si aucun type n'est spécifié, tous les types sont renvoyés.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Arguments : aucun
Cet événement est déclenché lorsqu'un PlaceResult est disponible pour un lieu sélectionné par l'utilisateur.
Si l'utilisateur saisit le nom d'un lieu qui n'a pas été suggéré par la commande et appuie sur la touche Entrée, ou si la requête Places Details échoue, PlaceResult contient l'entrée utilisateur dans la propriété name, sans définir d'autres propriétés.

Interface AutocompleteOptions

google.maps.places.AutocompleteOptions interface

Options pouvant être définies sur un objet Autocomplete.

Nécessite le paramètre d'URL &libraries=places. Consultez la section Bibliothèques dans l'API Maps JavaScript.

bounds optional
Zone dans laquelle rechercher des lieux.
componentRestrictions optional
Type : ComponentRestrictions optional
Restrictions des composants. Les restrictions des composants permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
fields optional
Type:Array<string> optional
Champs à inclure pour le lieu dans la réponse détaillée lorsque les informations ont été correctement récupérées, qui seront facturées. Si la valeur ['ALL'] est transmise, 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 à l'aide de points (par exemple, "geometry.location"). La valeur par défaut est ['ALL'].
placeIdOnly optional
Type:boolean optional
Indique si seuls les identifiants de lieu doivent être récupérés. Les résultats PlaceResult disponibles pour l'événement Place_changed ne contiennent que les champs place_id, types et name, et les champs Place_id, types et description sont renvoyés par le service Autocomplete. Désactivée par défaut.
strictBounds optional
Type:boolean optional
Valeur booléenne indiquant que le widget Autocomplete ne doit renvoyer que les lieux situés dans les limites du widget Autocomplete au moment de l'envoi de la requête. Si vous définissez strictBounds sur false (valeur par défaut), les résultats tendent vers les lieux contenus dans les limites, sans s'y limiter.
types optional
Type:Array<string> optional
Types de prédictions à afficher. Pour connaître les types compatibles, consultez le guide du développeur. Si aucun type n'est spécifié, tous les types sont renvoyés.

Classe google.maps.places.SearchBox

Widget fournissant des prédictions de requête basées sur le texte saisi par l'utilisateur. Il s'associe à un élément d'entrée de type text et écoute l'entrée de texte dans ce champ. La liste des prédictions s'affiche sous la forme d'une liste déroulante. Elle est mise à jour au fur et à mesure que vous saisissez du texte.

Cette classe étend MVCObject.

Nécessite le paramètre d'URL &libraries=places. Consultez la section Bibliothèques dans l'API Maps JavaScript.

SearchBox
SearchBox(inputField[, opts])
Paramètres:
Crée une instance de SearchBox qui s'associe au champ de saisie spécifié avec les options données.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée: LatLngBounds|undefined
Renvoie les limites auxquelles les prédictions de requête sont biaisées.
getPlaces
getPlaces()
Paramètres : aucun
Valeur renvoyée: Array<PlaceResult>|undefined
Renvoie la requête sélectionnée par l'utilisateur à utiliser avec l'événement places_changed.
setBounds
setBounds(bounds)
Paramètres:
Valeur renvoyée:aucune
Définit la région à utiliser pour la pondération des prédictions de requête. Les résultats ne seront basés que sur cette zone et ne seront pas limités à celle-ci.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque l'utilisateur sélectionne une requête. Vous devez utiliser getPlaces pour obtenir de nouveaux lieux.

Interface SearchBoxOptions

google.maps.places.SearchBoxOptions interface

Options pouvant être définies sur un objet SearchBox.

Nécessite le paramètre d'URL &libraries=places. Consultez la section Bibliothèques dans l'API Maps JavaScript.

bounds optional
Zone vers laquelle pondérer les prédictions de requête. Les prédictions sont biaisées, sans s'y limiter, pour les requêtes ciblant ces limites.