Geocoder

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.
Geocoder
Geocoder()
Paramètres : aucun
Crée une instance de Geocoder qui envoie des requêtes de géocodage aux serveurs Google.
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.
address optional
Type : string optional
Adresse à géocoder. Vous devez fournir une seule valeur parmi address, location et placeId.
bounds optional
LatLngBounds dans lequel effectuer la recherche. Facultatif.
componentRestrictions 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.
BetaextraComputations optional
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.
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.
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.
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.
REQUEST_DENIED La page Web n'est pas autorisée à utiliser le geocoder.
UNKNOWN_ERROR Une requête de géocodage n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.
ZERO_RESULTS Aucun résultat trouvé pour cette GeocoderRequest.

Interface GeocoderResponse

Interface google.maps.GeocoderResponse

Réponse du géocodeur renvoyée par Geocoder contenant la liste des GeocoderResult.
results
Liste des GeocoderResult.
Betaaddress_descriptor optional
Type : AddressDescriptor optional
Description relationnelle d'un lieu. Inclut un ensemble classé de points de repère à proximité et les zones contenant le lieu cible. Il n'est renseigné que pour les demandes de géocodage inversé et uniquement lorsque ExtraGeocodeComputation.ADDRESS_DESCRIPTORS est activé.
plus_code optional
Type : PlacePlusCode optional
Plus Code associé au lieu.

Interface GeocoderResult

Interface google.maps.GeocoderResult

Résultat unique du geocoder récupéré à partir du serveur de géocodage. Une requête de géocodage peut renvoyer plusieurs objets de résultat. Notez que, bien que ce résultat soit "de type JSON", il n'est pas strictement au format JSON, car il inclut indirectement un objet LatLng.
address_components
Tableau de GeocoderAddressComponent
formatted_address
Type : string
Chaîne contenant l'adresse lisible de ce lieu.
geometry
Un objet GeocoderGeometry
place_id
Type : string
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.
types
Type : Array<string>
Tableau de chaînes indiquant le type de l'élément géocodé renvoyé. Pour obtenir la liste des chaînes possibles, consultez la section Types de composants d'adresse du guide du développeur.
Betaaddress_descriptor optional
Type : AddressDescriptor optional
Description relationnelle du lieu associé à ce code géographique. Inclut un ensemble classé de points de repère à proximité et les zones contenant le lieu cible. Ce champ ne sera renseigné que pour les requêtes de géocodage direct et de recherche d'ID de lieu, uniquement lorsque ExtraGeocodeComputation.ADDRESS_DESCRIPTORS est activé et uniquement pour certains lieux localisés.
partial_match optional
Type : boolean optional
Indique si le geocoder n'a pas renvoyé de correspondance exacte pour la requête d'origine, bien qu'il ait pu trouver une partie de l'adresse demandée. Si la correspondance est exacte, la valeur sera undefined.
plus_code optional
Type : PlacePlusCode optional
Plus Code associé au lieu.
postcode_localities optional
Type : Array<string> optional
Tableau de chaînes indiquant toutes les localités contenues dans un code postal. Ce composant est présent uniquement lorsque le résultat correspond à un code postal regroupant plusieurs localités.

Interface AddressDescriptor

Interface google.maps.AddressDescriptor