Autocomplete Data (new)

Classe AutocompleteSuggestion

Classe google.maps.places.AutocompleteSuggestion

Résultat de suggestion de saisie semi-automatique.

Accédez-y en appelant le const {AutocompleteSuggestion} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Paramètres :
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.
placePrediction
Type : PlacePrediction optional
Contient le nom lisible du résultat renvoyé. Pour les résultats d'établissements, il s'agit généralement du nom et de l'adresse de l'établissement.

 Si un AutocompleteRequest.sessionToken a été fourni dans l'AutocompleteRequest utilisé pour extraire cet 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

Interface google.maps.places.AutocompleteRequest

Interface de requête pour AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Type : string
Chaîne de texte sur laquelle effectuer la recherche.
includedPrimaryTypes optional
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 optional
Type : Array<string> optional
Incluez uniquement les résultats dans les régions spécifiées, sous 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 les deux définis, les résultats se trouveront dans la zone d'intersection.
inputOffset optional
Type : number optional
Décalage de caractère Unicode basé sur zéro (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 optional
Type : string optional
Langue dans laquelle renvoyer les résultats. La langue par défaut sera celle définie dans les préférences du navigateur. 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 optional
Type : LocationBias optional
Limiter les résultats à un lieu spécifié.

 Au maximum, une seule des valeurs locationBias ou locationRestriction doit être définie. Si aucun n'est défini, les résultats seront biaisés par l'adresse IP, ce qui signifie que l'adresse IP sera associée à un emplacement imprécis et utilisée comme signal de pondération.
locationRestriction optional
Type : LocationRestriction optional
Limiter les résultats à un emplacement spécifié

 Au maximum, une seule des valeurs locationBias ou locationRestriction doit être définie. Si aucun n'est défini, les résultats seront biaisés par l'adresse IP, ce qui signifie que l'adresse IP sera associée à un emplacement imprécis et utilisée comme signal de pondération.
origin optional
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.
region optional
Type : string optional
Code régional, spécifié sous forme de code CLDR à deux caractères. Cela affecte la mise en forme des adresses et le classement des résultats, et peut avoir une incidence sur les résultats renvoyés. Cela ne limite pas les résultats à la région spécifiée.
sessionToken optional
Type : AutocompleteSessionToken optional
Jeton qui identifie une session Autocomplete à des fins de facturation. Générez un jeton de session à l'aide de 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 à 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 suivre 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

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

Accédez-y en appelant le const {AutocompleteSessionToken} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
AutocompleteSessionToken
AutocompleteSessionToken()
Paramètres : aucun
Crée une instance de AutocompleteSessionToken.

Classe PlacePrediction

Classe google.maps.places.PlacePrediction

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

Accédez-y en appelant le const {PlacePrediction} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
distanceMeters
Type : number optional
Longueur de la géodésique en mètres à partir de origin si origin est spécifié.
mainText
Type : FormattableText optional
Représente le nom du lieu.
placeId
Type : string
Identifiant unique du lieu suggéré. Cet identifiant peut être utilisé dans d'autres API qui acceptent les ID de lieu.
secondaryText
Type : FormattableText optional
Représente des caractéristiques de clarification supplémentaires (telles qu'une ville ou une région) pour identifier davantage le lieu.
text
Contient le nom lisible du résultat renvoyé. Pour les résultats d'établissements, il s'agit généralement du nom et de l'adresse de l'établissement.

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'UI distincts, mais liés, peuvent utiliser PlacePrediction.mainText et PlacePrediction.secondaryText à la place.
types
Type : Array<string>
Liste des types qui s'appliquent à ce lieu à partir du tableau A ou du tableau B de la page https://developers.google.com/maps/documentation/places/web-service/place-types.
BetafetchAddressValidation
fetchAddressValidation(request)
Paramètres :
Valeur renvoyée : Promise<AddressValidation>
Envoie une requête Address Validation associée à cette session Autocomplete (en remplissant en interne la requête avec le jeton de session Autocomplete). Aucune information sur le lieu de PlacePrediction n'est incluse automatiquement. Il s'agit d'une méthode pratique pour faciliter la gestion des sessions Autocomplete.
toPlace
toPlace()
Paramètres : aucun
Valeur renvoyée : Place
Renvoie une représentation Place de cette 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.

 Vous pouvez également utiliser PlaceAutocompleteElement. Dans ce cas, le premier appel à Place.fetchFields sur un Place renvoyé par PlacePrediction.toPlace inclura automatiquement le jeton de session.

Classe StringRange

Classe google.maps.places.StringRange

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

Accédez-y en appelant le const {StringRange} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
endOffset
Type : number
Décalage de base zéro du dernier caractère Unicode de la sous-chaîne (exclusif).
startOffset
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

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

Accédez-y en appelant le const {FormattableText} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
matches
Liste des plages de chaînes identifiant les correspondances 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. Les sous-chaînes ne correspondent pas forcément exactement à AutocompleteRequest.input si la correspondance a été déterminée par des critères autres que la correspondance de chaînes (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 ordre croissant des valeurs de décalage.
text
Type : string
Texte qui peut être utilisé tel quel ou mis en forme avec FormattableText.matches.