places.Autocomplete

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 Autocomplete

classe google.maps.places.Autocomplete

Un service fournissant des prédictions sur l'endroit souhaité au fur et à mesure du texte saisi par l'utilisateur.

Il est rattaché à un élément <input/> de type text, et écoute le texte saisi dans ce champ.

La liste des prédictions se présente sous la forme d'une liste déroulante et est mise à jour au fur et à mesure que le texte est saisi.

Cette classe hérite de la classe MVCObject.

Bibliothèque

places

Constructeur
Evénement
Méthode
Constructeur places.Autocomplete
ConstructeurDescription
Autocomplete(
       inputField:HTMLInputElement,
       opts?:places.AutocompleteOptions
)

Crée une nouvelle instance de places.Autocomplete qui s'adapte à la zone de saisie de texte spécifiée avec les options indiquées.

Evénement places.Autocomplete
EvénementArgumentsDescription
place_changedArguments :  None 

Cet événement est déclenché quand un résultat places.PlaceResult est disponible pour le lieu sélectionné par l'utilisateur.

Si l'utilisateur entre le nom d'un lieu qui n'était pas suggéré par le contrôle et appuie sur la touche 'Enter', un événement place_changed sera déclenché qui contient les données saisies par l'utilisateur dans la propriété name sans aucune autre propriété définie.

Méthode places.Autocomplete
MéthodeValeur RetournéeDescription
getBounds()Valeur retournée : LatLngBounds

Retourne les limites d'influence des suggestions.

getPlace()Valeur retournée : places.PlaceResult

Retourne les détails concernant le lieu choisi par l'utilisateur, ou  null  si aucun lieu n'a encore été sélectionné.

setBounds(
       bounds:LatLngBounds
)
Valeur retournée :  None 

Définit la zone privilégiée au sein de laquelle retourner les résultats de lieux.

Les résultats sont influencés, mais non limités, par la zone définie.

setComponentRestrictions(
       restrictions:places.ComponentRestrictions
)
Valeur retournée :  None 

Définit les restrictions du composant.

Les restrictions de composant sont utilisées pour limiter les suggestions seulement à celles situées au sein de l'élément parent.

Par exemple, dans le pays.

setTypes(
       types: Array .< string >
)
Valeur retournée :  None 

Définit les types de suggestions à retourner.

Les types supportés sont :

  • 'establishment' pour les entreprises,
  • 'geocode' pour les adresses.

Si aucun type n'est spécifié, les deux types seront retournés.

La méthode setTypes accepte un tableau d'élément unique.