Places Widgets

Classe PlaceAutocompleteElement

Classe google.maps.places.PlaceAutocompleteElement

Implémentation d'AutocompleteView pour l'API Places

Cette classe implémente PlaceAutocompleteElementOptions.

Pour y accéder, appelez const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Paramètres: 
element optional
Type:HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
inputElement
Élément de saisie pour lequel la saisie semi-automatique doit s'afficher.
Hérité:componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Paramètres: 
  • eventNamestring
  • handlerFunction
Valeur renvoyée:  MapsEventListener
Ajoute la fonction d'écouteur donnée au nom d'événement donné.
gmp-placeselect
function(place)
Arguments: 
Cet événement est déclenché lorsqu'un utilisateur sélectionne une prédiction de lieu. Renvoie un objet Place.
gmp-requesterror
function()
Arguments:aucun
Cet événement est déclenché lorsqu'une requête adressée au backend a été refusée (clé API incorrecte, par exemple). Cet événement n'apparaît pas dans des bulles.

Interface PlaceAutocompleteElementOptions

Interface google.maps.places.PlaceAutocompleteElementOptions

Options de construction d'un élément PlaceAutocompleteElement.

inputElement
Élément de saisie pour lequel la saisie semi-automatique doit s'afficher.
componentRestrictions optional
Type:ComponentRestrictions optional
Restrictions des composants. Les restrictions de composant permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
element optional
Type:HTMLElement|SVGElement optional
Ce champ est en lecture seule. Élément DOM supportant la vue.
locationBias optional
Type:LocationBias optional
Limite ou indice doux à utiliser pour rechercher des lieux.
locationRestriction optional
Type:LocationRestriction optional
Limites permettant de limiter les résultats de recherche.
requestedLanguage optional
Type:string optional
Identifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Les résultats dans la langue sélectionnée peuvent obtenir un meilleur classement, mais les suggestions ne sont pas limitées à cette langue. Consultez la liste des langues disponibles.
requestedRegion optional
Type:string optional
Code de région utilisé pour la mise en forme et le filtrage des résultats. Les suggestions ne sont pas limitées à ce pays. 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").
types optional
Type:Array<string> optional
Types de prédictions à renvoyer. 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 Autocomplete

Classe google.maps.places.Autocomplete

Widget qui fournit des prédictions de lieu en fonction du texte saisi par l'utilisateur. Il s'associe à un élément d'entrée 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 à mesure que du texte est saisi.

Cette classe étend MVCObject.

Pour y accéder, appelez const {Autocomplete} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

Autocomplete
Autocomplete(inputField[, opts])
Paramètres: 
Crée une instance de Autocomplete qui est associée au champ de texte d'entrée spécifié avec les options données.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée:LatLngBounds|undefined Limites de pondération.
Renvoie les limites de pondération des prédictions.
getFields
getFields()
Paramètres:aucun
Valeur renvoyée:  Array<string>|undefined
Renvoie les champs à inclure pour le lieu dans la réponse "details" lorsque les informations ont été correctement récupérées. Pour obtenir la liste des champs, consultez PlaceResult.
getPlace
getPlace()
Paramètres:aucun
Return Value (Valeur renvoyée) : PlaceResult le lieu sélectionné par l'utilisateur.
Renvoie les informations sur le lieu sélectionné par l'utilisateur si elles ont été correctement récupérées. Sinon, renvoie un objet Place bouchon, avec la propriété name définie sur la valeur actuelle du champ de saisie.
setBounds
setBounds(bounds)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Définit la zone préférée dans laquelle renvoyer des résultats de lieu. Les résultats sont orientés vers ce domaine, sans s'y limiter.
setComponentRestrictions
setComponentRestrictions(restrictions)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Définit les restrictions des composants. Les restrictions de composant permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
setFields
setFields(fields)
Paramètres: 
  • fieldsArray<string> optional
Return Value (Valeur renvoyée) : aucune
Définit les champs à inclure pour le lieu dans la réponse "Details" (Détails) une fois les informations récupérées. Pour obtenir la liste des champs, consultez PlaceResult.
setOptions
setOptions(options)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
setTypes
setTypes(types)
Paramètres: 
  • typesArray<string> optional types de prédictions à inclure.
Return Value (Valeur renvoyée) : aucune
Définit les types de prédictions à renvoyer. 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 une requête Place Details échoue, PlaceResult contient l'entrée utilisateur dans la propriété name, sans aucune autre propriété définie.

Interface AutocompleteOptions

Interface google.maps.places.AutocompleteOptions

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

bounds optional
Zone dans laquelle rechercher des lieux.
componentRestrictions optional
Type:ComponentRestrictions optional
Restrictions des composants. Les restrictions de composant 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 "details" une fois les informations récupérées, qui seront facturées. 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 à l'aide de points (par exemple, "geometry.location"). La valeur par défaut est ['ALL'].
placeIdOnly optional
Type:boolean optional
Indique si seuls les ID de lieu doivent être récupérés. Le PlaceResult mis à disposition lors du déclenchement de l'événement place_changed ne contiendra que les champs "place_id", "types" et "name", ainsi que le place_id, les types et la description renvoyés par le service Autocomplete. Désactivés par défaut
strictBounds optional
Type:boolean optional
Valeur booléenne indiquant que le widget Autocomplete ne doit renvoyer que les lieux situés à l'intérieur des limites du widget Autocomplete au moment de l'envoi de la requête. Si vous définissez la valeur strictBounds sur false (valeur par défaut), les résultats sont pondérés en fonction des lieux situés entre les limites, sans s'y limiter.
types optional
Type:Array<string> optional
Types de prédictions à renvoyer. 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 qui fournit des prédictions de requête en fonction du texte saisi par un utilisateur. Il s'associe à un élément d'entrée 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 à mesure que du texte est saisi.

Cette classe étend MVCObject.

Pour y accéder, appelez const {SearchBox} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

SearchBox
SearchBox(inputField[, opts])
Paramètres: 
Crée une instance de SearchBox qui est associée au champ de texte d'entrée spécifié avec les options données.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée:  LatLngBounds|undefined
Renvoie les limites de pondération des prédictions de requête.
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: 
Return Value (Valeur renvoyée) : aucune
Définit la région à utiliser pour pondérer les prédictions des requêtes. Les résultats n'auront d'incidence que sur cette zone et ne seront pas totalement restreints à 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. getPlaces doit être utilisé pour obtenir de nouveaux lieux.

SearchBoxOptions.

Interface google.maps.places.SearchBoxOptions

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

bounds optional
Zone dans laquelle pondérer les prédictions des requêtes. Les prédictions sont orientées vers les requêtes ciblant ces limites, mais ne s'y limitent pas.