Autocomplete Data (new)

Interface AutocompleteRequest

Interface google.maps.places.AutocompleteRequest

Interface de requête pour AutocompleteSuggestion.fetchAutocompleteSuggestions.

Propriétés
input	Type:string Chaîne de texte dans laquelle effectuer la recherche.
includedPrimaryTypes optional	Type:Array<string> optional Type de lieu principal inclus (par exemple, "restaurant" ou "station-service"). Un lieu n'est renvoyé que si son type principal figure dans cette liste. Vous pouvez spécifier jusqu'à cinq valeurs. Si aucun type n'est spécifié, tous les types de lieu sont renvoyés.
includedRegionCodes optional	Type:Array<string> optional Incluez les résultats uniquement dans les régions spécifiées, avec un maximum de 15 codes régionaux à deux caractères CLDR. Un ensemble vide ne limite pas les résultats. Si les champs locationRestriction et includedRegionCodes sont tous les deux définis, les résultats sont présentés dans la zone de l'intersection.
inputOffset optional	Type:number optional Décalage de caractère Unicode de base à 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 définie sur input.
language optional	Type:string optional Langue dans laquelle les résultats doivent être renvoyés. Les préférences linguistiques du navigateur seront appliquées par défaut. Les résultats peuvent être rédigés dans différentes langues si la langue utilisée dans input est différente de language, ou si le lieu renvoyé ne possède pas de traduction de la langue locale vers la langue language.
locationBias optional	Type:LocationBias optional Limiter les résultats à un emplacement spécifié Vous ne devez définir que locationBias ou locationRestriction. Si aucune de ces valeurs n'est définie, les résultats sont pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP est associée à un emplacement imprécis et utilisée comme signal de pondération.
locationRestriction optional	Type:LocationRestriction optional Limite les résultats à un emplacement spécifié. Vous ne devez définir que locationBias ou locationRestriction. Si aucune de ces valeurs n'est définie, les résultats sont pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP est associée à un emplacement imprécis et utilisée comme signal de pondération.
origin optional	Type:LatLng|LatLngLiteral optional Point de départ à partir duquel calculer la distance géodésique jusqu'à la destination (renvoyé sous la forme PlacePrediction.distanceMeters). Si cette valeur est omise, la distance géodésique n'est pas renvoyée.
region optional	Type:string optional Code régional, spécifié sous la forme d'un code régional CLDR à deux caractères. Cela affecte le format 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 optional	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 seul appel fetchFields. Les identifiants utilisés pour chaque requête au sein d'une session doivent appartenir au même projet dans la console Google Cloud. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre sessionToken est omis 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). 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 sera facturée séparément.

Classe AutocompleteSessionToken

Classe google.maps.places.AutocompleteSessionToken

Représente un jeton de session utilisé pour le suivi d'une session de saisie semi-automatique.

Accès en appelant const {AutocompleteSessionToken} = await google.maps.importLibrary("places") Consultez Bibliothèques dans l'API Maps JavaScript.

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

Classe AutocompleteSuggestion

Classe google.maps.places.AutocompleteSuggestion

Résultat de la suggestion de saisie semi-automatique.

Accès en appelant const {AutocompleteSuggestion} = await google.maps.importLibrary("places") Consultez Bibliothèques dans l'API Maps JavaScript.

Méthodes statiques
fetchAutocompleteSuggestions	fetchAutocompleteSuggestions(autocompleteRequest) Paramètres:  autocompleteRequest:  AutocompleteRequest Valeur renvoyée:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Récupère une liste de AutocompleteSuggestions.

Propriétés
placePrediction	Type:PlacePrediction optional Contient le nom lisible du résultat renvoyé. Dans les résultats d'un établissement, il s'agit généralement du nom et de l'adresse de l'établissement.

Classe PlacePrediction

Classe google.maps.places.PlacePrediction

Résultats d'une prédiction Place Autocomplete

Accès en appelant const {PlacePrediction} = await google.maps.importLibrary("places") Consultez Bibliothèques dans l'API Maps JavaScript.

Propriétés
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 éléments géographiques supplémentaires (tels qu'une ville ou une région) permettant d'identifier le lieu de façon plus précise.
text	Type:FormattableText Contient le nom lisible du résultat renvoyé. Dans les résultats d'un établissement, 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'interface utilisateur 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 B de la page https://developers.google.com/maps/documentation/places/web-service/place-types.

Méthodes
toPlace	toPlace() Paramètres:aucun Valeur renvoyée:  Place Renvoie une représentation de lieu de cette prédiction de lieu. Un appel ultérieur à Place.fetchFields est nécessaire pour obtenir tous les détails sur le lieu.

Classe StringRange

Classe google.maps.places.StringRange

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

Accès en appelant const {StringRange} = await google.maps.importLibrary("places") Consultez Bibliothèques dans l'API Maps JavaScript.

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

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ès en appelant const {FormattableText} = await google.maps.importLibrary("places") Consultez Bibliothèques dans l'API Maps JavaScript.

Propriétés
matches	Type:Array<StringRange> Liste de plages de chaînes identifiant où la requête d'entrée a été mise en correspondance dans FormattableText.text. Les plages peuvent être utilisées pour mettre en forme des parties spécifiques de text. Les sous-chaînes peuvent ne pas être des correspondances exactes de AutocompleteRequest.input si la correspondance a été déterminée par d'autres critères 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. Vous êtes certain que les plages sont classées dans des valeurs de décalage croissantes.
text	Type:string Texte pouvant être utilisé tel quel ou mis en forme avec FormattableText.matches.