Classe Geocoder
Classe google.maps.Geocoder
Service permettant de convertir une adresse en LatLng
et inversement.
Accédez-y en appelant le const {Geocoder} = await google.maps.importLibrary("geocoding")
.
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
Geocoder |
Geocoder() Paramètres : aucun
Crée une instance de Geocoder qui envoie des requêtes de géocodage aux serveurs Google. |
Méthodes | |
---|---|
geocode |
geocode(request[, callback]) Paramètres :
Valeur renvoyée :
Promise<GeocoderResponse> Géocode une requête. |
Interface GeocoderRequest
Interface google.maps.GeocoderRequest
Spécification d'une requête de géocodage à envoyer à Geocoder
.
Propriétés | |
---|---|
address optional |
Type :
string optional Adresse à géocoder. Vous devez fournir une seule valeur parmi address , location et placeId . |
bounds optional |
Type :
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds dans lequel effectuer la recherche. Facultatif. |
componentRestrictions optional |
Type :
GeocoderComponentRestrictions optional Les composants permettent de limiter les résultats à une zone spécifique. Un filtre se compose d'un ou de plusieurs des éléments suivants : route , locality , administrativeArea , postalCode , country . Seuls les résultats correspondant à tous les filtres sont renvoyés. Les valeurs de filtre prennent en charge les mêmes méthodes de correction orthographique et de correspondance partielle que les autres requêtes de géocodage. Facultatif. |
|
Type :
Array<ExtraGeocodeComputation> optional Liste des calculs supplémentaires pouvant être utilisés pour traiter la demande. Remarque : Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires dans la réponse. |
fulfillOnZeroResults optional |
Type :
boolean optional Respectez la promesse d'un état ZERO_RESULT dans la réponse. Cela peut être souhaitable, car même en l'absence de résultats de géocodage, des champs supplémentaires au niveau de la réponse peuvent toujours être renvoyés. |
language optional |
Type :
string optional Identifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Consultez la liste des langues disponibles. |
location optional |
Type :
LatLng|LatLngLiteral optional LatLng (ou LatLngLiteral ) à rechercher. Le geocoder effectue un geocoding inversé. Pour en savoir plus, consultez Geocoding inversé. Vous devez fournir une seule valeur parmi address , location et placeId . |
placeId optional |
Type :
string optional ID du lieu associé à l'établissement. Les ID de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps. Pour en savoir plus sur les ID de lieux, consultez le guide du développeur de l'API Places. Le geocoder effectue un geocoding inversé. Pour en savoir plus, consultez Geocoding inversé. Vous devez fournir une seule valeur parmi address , location et placeId . |
region optional |
Type :
string optional Code pays utilisé pour orienter la recherche, spécifié sous forme de sous-tag de région Unicode à deux caractères (non numériques) ou d'identifiant CLDR. Facultatif. Consultez Détails de la couverture Google Maps Platform pour obtenir la liste des régions acceptées. |
Interface GeocoderComponentRestrictions
Interface google.maps.GeocoderComponentRestrictions
GeocoderComponentRestrictions
représente un ensemble de filtres qui correspondent à une zone spécifique. Pour en savoir plus sur son fonctionnement, consultez Filtrage des composants de géocodage.
Propriétés | |
---|---|
administrativeArea optional |
Type :
string optional Correspond à tous les administrative_area levels . Facultatif. |
country optional |
Type :
string optional Correspond à un nom de pays ou à un code pays ISO 3166-1 à deux lettres. Facultatif. |
locality optional |
Type :
string optional Correspond aux types locality et sublocality . Facultatif. |
postalCode optional |
Type :
string optional Correspond à postal_code et postal_code_prefix . Facultatif. |
route optional |
Type :
string optional Correspond au nom long ou court d'un route . Facultatif. |
Constantes ExtraGeocodeComputation
google.maps.ExtraGeocodeComputation
constantes
Calculs supplémentaires à effectuer lors du traitement d'une demande de géocodage.
Accédez-y en appelant le const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
.
Consultez Bibliothèques de l'API Maps JavaScript.
Constantes | |
---|---|
ADDRESS_DESCRIPTORS |
Générez un descripteur d'adresse. |
Constantes GeocoderStatus
google.maps.GeocoderStatus
constantes
État renvoyé par Geocoder
à la fin d'un appel à geocode()
. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'OK'
ou google.maps.GeocoderStatus.OK
.
Accédez-y en appelant le const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
.
Consultez Bibliothèques de l'API Maps JavaScript.
Constantes | |
---|---|
ERROR |
Un problème est survenu lors de la communication avec les serveurs Google. |
INVALID_REQUEST |
Ce GeocoderRequest n'est pas valide. |
OK |
La réponse contient un GeocoderResponse valide. |
OVER_QUERY_LIMIT |
La page Web a dépassé la limite de requêtes sur une période trop courte. |
|