Places Autocomplete Service

Classe AutocompleteService

Classe google.maps.places.AutocompleteService

Contient des méthodes liées à la récupération des prédictions de saisie semi-automatique.

Pour y accéder, appelez const {AutocompleteService} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
AutocompleteService
AutocompleteService()
Paramètres:aucun
Crée une instance de AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Paramètres: 
Valeur renvoyée:  Promise<AutocompleteResponse>
Récupère les prédictions de saisie semi-automatique de lieu en fonction de la requête de saisie semi-automatique fournie.
getQueryPredictions
getQueryPredictions(request, callback)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Récupère les prédictions de saisie semi-automatique de la requête en fonction de la requête de saisie semi-automatique fournie.

Interface AutocompletionRequest

Interface google.maps.places.AutocompletionRequest

Requête de saisie semi-automatique à envoyer à AutocompleteService.getPlacePredictions.
input
Type:string
L'utilisateur a saisi une chaîne.
bounds optional
Limites pour la pondération des prédictions. Les prédictions seront biaisées en fonction du bounds donné, sans s'y limiter. location et radius sont ignorés si bounds est défini.
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.
language 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.
location optional
Type:LatLng optional
Emplacement pour la pondération des prédictions. Les prédictions seront biaisées par rapport aux valeurs location et radius indiquées. Vous pouvez également utiliser bounds.
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.
offset optional
Type:number optional
Position du caractère dans le terme d'entrée auquel le service utilise le texte pour les prédictions (position du curseur dans le champ de saisie).
origin optional
Type:LatLng|LatLngLiteral optional
Zone à partir de laquelle la valeur AutocompletePrediction.distance_meters est calculée.
radius optional
Type:number optional
Rayon de la zone utilisée pour la pondération des prédictions. La valeur radius est spécifiée en mètres et doit toujours être accompagnée d'une propriété location. Vous pouvez également utiliser bounds.
region 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").
sessionToken optional
Référence unique utilisée pour regrouper des requêtes individuelles dans des sessions.
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.

Interface AutocompleteResponse

Interface google.maps.places.AutocompleteResponse

Réponse de saisie semi-automatique renvoyée par l'appel à AutocompleteService.getPlacePredictions, qui contient une liste d'éléments AutocompletePrediction.
predictions
Liste des AutocompletePrediction.

Interface QueryAutocompletionRequest

Interface google.maps.places.QueryAutocompletionRequest

Requête QueryAutocomplete à envoyer à QueryAutocompleteService.
input
Type:string
L'utilisateur a saisi une chaîne.
bounds optional
Limites pour la pondération des prédictions. Les prédictions seront biaisées en fonction du bounds donné, sans s'y limiter. location et radius sont ignorés si bounds est défini.
location optional
Type:LatLng optional
Emplacement pour la pondération des prédictions. Les prédictions seront biaisées par rapport aux valeurs location et radius indiquées. Vous pouvez également utiliser bounds.
offset optional
Type:number optional
Position du caractère dans le terme d'entrée auquel le service utilise le texte pour les prédictions (position du curseur dans le champ de saisie).
radius optional
Type:number optional
Rayon de la zone utilisée pour la pondération des prédictions. La valeur radius est spécifiée en mètres et doit toujours être accompagnée d'une propriété location. Vous pouvez également utiliser bounds.

Classe AutocompleteSessionToken

Classe google.maps.places.AutocompleteSessionToken

Représente un jeton de session utilisé pour suivre une session de saisie semi-automatique, qui peut être une série d'appels AutocompleteService.getPlacePredictions suivis d'un seul appel PlacesService.getDetails.

Pour y accéder, appelez const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
AutocompleteSessionToken
AutocompleteSessionToken()
Paramètres:aucun
Crée une instance de AutocompleteSessionToken.

ComponentRestrictions.

Interface google.maps.places.ComponentRestrictions

Définit les restrictions de composants pouvant être utilisées avec le service de saisie semi-automatique.
country optional
Type:string|Array<string> optional
Limite les prédictions au pays spécifié (code pays ISO 3166-1 alpha-2, non sensible à la casse). Exemples : 'us', 'br' ou 'au'. Vous pouvez fournir une seule chaîne ou un tableau comportant jusqu'à cinq chaînes de code pays.

Interface AutocompletePrediction

Interface google.maps.places.AutocompletePrediction

Représente une seule prédiction de saisie semi-automatique.
description
Type:string
Il s'agit de la version non formatée de la requête suggérée par le service Places.
matched_substrings
Ensemble de sous-chaînes dans la description du lieu qui correspondent aux éléments de l'entrée utilisateur, pouvant être utilisée pour mettre en surbrillance ces sous-chaînes. Chaque sous-chaîne est identifiée par un décalage et une longueur, exprimées en caractères Unicode.
place_id
Type:string
ID de lieu permettant d'obtenir des informations sur ce lieu à l'aide du service Place Details (voir PlacesService.getDetails).
structured_formatting
Informations structurées sur la description du lieu, divisées en un texte principal et un texte secondaire, y compris un tableau de sous-chaînes correspondantes issues de la saisie semi-automatique, identifiées par un décalage et une longueur, exprimées en caractères Unicode.
terms
Informations sur les termes individuels figurant dans la description ci-dessus, du plus spécifique au moins spécifique. Exemples : "Taco Bell", "Willitis" et "CA".
types
Type:Array<string>
Tableau des types auxquels appartient la prédiction, par exemple 'establishment' ou 'geocode'.
distance_meters optional
Type:number optional
Distance en mètres du lieu par rapport au AutocompletionRequest.origin.

Interface QueryAutocompletePrediction

Interface google.maps.places.QueryAutocompletePrediction

Représente une prédiction de saisie semi-automatique de requête unique.
description
Type:string
Il s'agit de la version non formatée de la requête suggérée par le service Places.
matched_substrings
Ensemble de sous-chaînes dans la description du lieu qui correspondent aux éléments de l'entrée utilisateur, pouvant être utilisée pour mettre en surbrillance ces sous-chaînes. Chaque sous-chaîne est identifiée par un décalage et une longueur, exprimées en caractères Unicode.
terms
Informations sur les termes individuels dans la description ci-dessus. Les termes catégorielles apparaissent en premier (par exemple, "restaurant"). Les termes d'adresse apparaissent du plus spécifique au moins spécifique. Exemples : "San Francisco" et "CA".
place_id optional
Type:string optional
Disponible uniquement si la prédiction est un lieu. ID de lieu permettant d'obtenir des informations sur ce lieu à l'aide du service Place Details (voir PlacesService.getDetails).

Interface PredictionTerm

Interface google.maps.places.PredictionTerm

Représente un terme de prédiction.
offset
Type:number
Décalage, en caractères Unicode, du début de ce terme dans la description du lieu.
value
Type:string
Valeur de ce terme, par exemple "Taco Bell".

Interface PredictionSubstring

Interface google.maps.places.PredictionSubstring

Représente une sous-chaîne de prédiction.
length
Type:number
Longueur de la sous-chaîne.
offset
Type:number
Décalage par rapport au début de la sous-chaîne dans la chaîne de description.

StructuredFormatting.

Interface google.maps.places.StructuredFormatting

Contient des informations structurées sur la description du lieu, divisées en un texte principal et un texte secondaire, y compris un tableau de sous-chaînes correspondantes issues de la saisie semi-automatique, identifiées par un décalage et une longueur, exprimées en caractères Unicode.
main_text
Type:string
Il s'agit du texte principal de la description sans mise en forme du lieu suggéré par le service Places. Il s'agit généralement du nom du lieu.
main_text_matched_substrings
Ensemble de sous-chaînes dans le texte principal qui correspondent aux éléments de l'entrée utilisateur, adaptée à la mise en surbrillance de ces sous-chaînes. Chaque sous-chaîne est identifiée par un décalage et une longueur, exprimées en caractères Unicode.
secondary_text
Type:string
Il s'agit du texte secondaire de la description sans mise en forme du lieu suggéré par le service Places. Il s'agit généralement de l'emplacement du lieu.