Autocomplete Data

Classe AutocompleteSuggestion

Classe google.maps.places.AutocompleteSuggestion
library "places"

Résultat d'une suggestion de saisie semi-automatique.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");

Méthodes statiques

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Paramètres : autocompleteRequest : AutocompleteRequest Valeur renvoyée : Promise<{suggestions:Array<AutocompleteSuggestion>}> Récupère une liste d'AutocompleteSuggestions. Si un AutocompleteRequest.sessionToken est fourni dans la requête, ce jeton de session sera automatiquement inclus lors du premier appel de Place.fetchFields, sur chaque Place renvoyé par PlacePrediction.toPlace sur les PlacePrediction résultants.

Propriétés

placePrediction readonly

Type : PlacePrediction optional Contient le nom lisible par l'humain du résultat renvoyé. Pour les résultats d'établissement, il s'agit généralement du nom et de l'adresse de l'entreprise. Si un AutocompleteRequest.sessionToken a été fourni dans la requête AutocompleteRequest utilisée pour récupérer cette AutocompleteSuggestion, le même jeton sera automatiquement inclus lors du premier appel de Place.fetchFields sur le Place renvoyé par un appel à PlacePrediction.toPlace.

Interface AutocompleteRequest

google.maps.places.AutocompleteRequest interface

Interface de requête pour AutocompleteSuggestion.fetchAutocompleteSuggestions.

Propriétés
input	Type : string Chaîne de texte sur laquelle effectuer la recherche.
futureOpeningBusinessesIncluded facultatif	Type : boolean optional Incluez des prédictions de lieux pour les établissements qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
includedPrimaryTypes facultatif	Type : Array<string> optional Type de lieu principal inclus (par exemple, "restaurant" ou "gas_station"). Un lieu n'est renvoyé que si son type principal est inclus dans cette liste. Vous pouvez spécifier jusqu'à cinq valeurs. Si aucun type n'est spécifié, tous les types de lieux sont renvoyés.
includedRegionCodes facultatif	Type : Array<string> optional Incluez uniquement les résultats dans les régions spécifiées, sous la forme de 15 codes de région CLDR à deux caractères maximum. Un ensemble vide ne limitera pas les résultats. Si locationRestriction et includedRegionCodes sont tous deux définis, les résultats se trouveront dans la zone d'intersection.
inputOffset facultatif	Type : number optional Un décalage de caractères Unicode basé sur zéro de input indiquant la position du curseur dans input. La position du curseur peut influencer les prédictions renvoyées. Si aucune valeur n'est spécifiée, la valeur par défaut est la longueur de input.
language facultatif	Type : string optional Langue dans laquelle les résultats doivent être renvoyés. La langue préférée du navigateur sera utilisée par défaut. Les résultats peuvent être dans plusieurs langues si la langue utilisée dans input est différente de language, ou si le lieu renvoyé n'a pas de traduction de la langue locale vers language.
locationBias facultatif	Type : LocationBias optional Limiter les résultats à un emplacement spécifié. Vous ne devez définir qu'un seul des champs locationBias ou locationRestriction. Si aucun de ces paramètres n'est défini, les résultats seront pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP sera mappée à un emplacement imprécis et utilisée comme signal de pondération.
locationRestriction facultatif	Type : LocationRestriction optional Limiter les résultats à un emplacement spécifié. Vous ne devez définir qu'un seul des champs locationBias ou locationRestriction. Si aucun de ces paramètres n'est défini, les résultats seront pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP sera mappée à un emplacement imprécis et utilisée comme signal de pondération.
origin facultatif	Type : LatLng|LatLngLiteral optional Point d'origine à partir duquel calculer la distance géodésique jusqu'à la destination (renvoyée sous la forme PlacePrediction.distanceMeters). Si cette valeur est omise, la distance géodésique ne sera pas renvoyée.
pureServiceAreaBusinessesIncluded facultatif	Type : boolean optional Incluez les établissements de services de proximité purs si le champ est défini sur "true". Un établissement de services de proximité est un établissement qui se rend directement chez les clients pour effectuer une prestation ou leur livrer des produits, mais qui n'accueille pas les clients à son adresse professionnelle. Par exemple, les établissements proposant des services de nettoyage ou de plomberie n'ont pas forcément d'adresse physique ni de lieu sur Google Maps.
region facultatif	Type : string optional Code régional, spécifié sous forme de code de région CLDR à deux caractères. Cela affecte la mise en forme des adresses, le classement des résultats et peut influencer les résultats renvoyés. Cela ne limite pas les résultats à la région spécifiée.
sessionToken facultatif	Type : AutocompleteSessionToken optional Jeton qui identifie une session Autocomplete à des fins de facturation. Générez un nouveau jeton de session via AutocompleteSessionToken. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et appelle Place.fetchFields. Chaque session peut comporter plusieurs requêtes, suivies d'un appel fetchFields. Les identifiants utilisés pour chaque requête d'une session doivent appartenir au même projet de la console Google Cloud. Lorsque la session prend fin, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si vous omettez le paramètre sessionToken ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément). Lorsqu'un jeton de session est fourni dans la requête adressée à AutocompleteSuggestion.fetchAutocompleteSuggestions, le même jeton est automatiquement inclus dans le premier appel à fetchFields sur un Place renvoyé en appelant PlacePrediction.toPlace sur l'un des AutocompleteSuggestion résultants. Nous vous recommandons de respecter les consignes suivantes : Utilisez des jetons de session pour tous les appels Place Autocomplete. Générez un nouveau jeton pour chaque session. N'oubliez pas de transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête est facturée individuellement.

Classe AutocompleteSessionToken

Classe google.maps.places.AutocompleteSessionToken
library "places"

Représente un jeton de session utilisé pour suivre une session de saisie semi-automatique.

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");

Constructeur
AutocompleteSessionToken	AutocompleteSessionToken() Paramètres : aucun Crée une instance de AutocompleteSessionToken.

Classe PlacePrediction

Classe google.maps.places.PlacePrediction
library "places"

Résultats de prédiction pour une prédiction Place Autocomplete.

const {PlacePrediction} = await google.maps.importLibrary("places");

Propriétés
distanceMeters readonly	Type : number optional Longueur de la géodésique en mètres à partir de origin si origin est spécifié.
mainText readonly	Type : FormattableText optional Représente le nom du lieu.
placeId readonly	Type : string Identifiant unique du lieu suggéré. Cet identifiant peut être utilisé dans d'autres API qui acceptent les ID de lieu.
secondaryText readonly	Type : FormattableText optional Représente des caractéristiques de désambiguïsation supplémentaires (comme une ville ou une région) pour identifier plus précisément le lieu.
text readonly	Type : FormattableText Contient le nom lisible par l'humain du résultat renvoyé. Pour les résultats d'établissement, il s'agit généralement du nom et de l'adresse de l'entreprise. text est recommandé pour les développeurs qui souhaitent afficher un seul élément d'interface utilisateur. Les développeurs qui souhaitent afficher deux éléments d'interface utilisateur distincts, mais liés, peuvent utiliser PlacePrediction.mainText et PlacePrediction.secondaryText à la place.
types readonly	Type : Array<string> Liste des types qui s'appliquent à ce lieu, d'après le tableau A ou le tableau B de la page https://developers.google.com/maps/documentation/places/web-service/place-types.

Méthodes
fetchAddressValidation	Remarque : Disponible uniquement dans la version bêta. fetchAddressValidation(request) Paramètres : request : AddressValidationRequest Valeur renvoyée : Promise<AddressValidation> Envoie une requête Address Validation associée à cette session de saisie semi-automatique (en renseignant en interne la requête avec le jeton de session de saisie semi-automatique). Aucune information sur le lieu provenant de PlacePrediction n'est incluse automatiquement. Il s'agit d'une méthode pratique pour faciliter la gestion des sessions de saisie semi-automatique.
toPlace	toPlace() Paramètres : aucun Valeur renvoyée : Place Renvoie une représentation Place de ce PlacePrediction. Un appel ultérieur à Place.fetchFields est nécessaire pour obtenir tous les détails du lieu. Si un AutocompleteRequest.sessionToken a été fourni dans le AutocompleteRequest utilisé pour récupérer cette PlacePrediction, le même jeton sera automatiquement inclus lors de l'appel de fetchFields. Sinon, lorsque vous utilisez PlaceAutocompleteElement, le premier appel à Place.fetchFields sur un Place renvoyé par PlacePrediction.toPlace inclut automatiquement le jeton de session.

Classe StringRange

Classe google.maps.places.StringRange
library "places"

Identifie une sous-chaîne dans un texte donné.

const {StringRange} = await google.maps.importLibrary("places");

Propriétés
endOffset readonly	Type : number Décalage basé sur zéro du dernier caractère Unicode de la sous-chaîne (exclusif).
startOffset readonly	Type : number Décalage basé sur zéro du premier caractère Unicode de la sous-chaîne (inclus).

Classe FormattableText

Classe google.maps.places.FormattableText
library "places"

Texte représentant une prédiction de lieu. Le texte peut être utilisé tel quel ou formaté.

const {FormattableText} = await google.maps.importLibrary("places");

Propriétés
matches readonly	Type : Array<StringRange> Liste de plages de chaînes identifiant l'emplacement de la requête d'entrée dans FormattableText.text. Les plages peuvent être utilisées pour mettre en forme des parties spécifiques de text. Il est possible que les sous-chaînes ne correspondent pas exactement à AutocompleteRequest.input si la correspondance a été déterminée par des critères autres que la correspondance de chaîne (par exemple, des corrections orthographiques ou des translittérations). Ces valeurs sont des décalages de caractères Unicode de FormattableText.text. Les plages sont garanties d'être classées par valeurs de décalage croissantes.
text readonly	Type : string Texte pouvant être utilisé tel quel ou formaté avec FormattableText.matches.