Class Geocoder

Geocoder

Permet de convertir une adresse en coordonnées géographiques.
L'exemple ci-dessous montre comment utiliser cette classe pour trouver les neuf premiers résultats correspondant à l'emplacement "Main St" dans le Colorado, les ajouter à une carte, puis les intégrer dans un nouveau document Google. 

// Find the best matches for "Main St" in Colorado.
const response = Maps.newGeocoder()
                     // The latitudes and longitudes of southwest and northeast
                     // corners of Colorado, respectively.
                     .setBounds(36.998166, -109.045486, 41.001666, -102.052002)
                     .geocode('Main St');

// Create a Google Doc and map.
const doc = DocumentApp.create('My Map');
const map = Maps.newStaticMap();

// Add each result to the map and doc.
for (let i = 0; i < response.results.length && i < 9; i++) {
  const result = response.results[i];
  map.setMarkerStyle(null, null, i + 1);
  map.addMarker(result.geometry.location.lat, result.geometry.location.lng);
  doc.appendListItem(result.formatted_address);
}

// Add the finished map to the doc.
doc.appendImage(Utilities.newBlob(map.getMapImage(), 'image/png'));

Voir aussi

Méthodes

MéthodeType renvoyéBrève description
geocode(address)ObjectRécupère les points géographiques approximatifs d'une adresse donnée.
reverseGeocode(latitude, longitude)ObjectRécupère les adresses approximatives d'un point géographique donné.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDéfinit les limites d'une zone qui doit être privilégiée dans les résultats.
setLanguage(language)GeocoderDéfinit la langue à utiliser dans les résultats.
setRegion(region)GeocoderDéfinit une région à utiliser lors de l'interprétation des noms de lieux.

Documentation détaillée

geocode(address)

Récupère les points géographiques approximatifs d'une adresse donnée. 

// Gets the geographic coordinates for Times Square.
const response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Paramètres

NomTypeDescription
addressStringune adresse

Renvois

Object : objet JSON contenant les données de géocodage, comme décrit ici

reverseGeocode(latitude, longitude)

Récupère les adresses approximatives d'un point géographique donné. 

// Gets the address of a point in Times Square.
const response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Paramètres

NomTypeDescription
latitudeNumberla latitude du point ;
longitudeNumberla longitude du point ;

Renvois

Object : objet JSON contenant les données de géocodage inverse, comme décrit ici

Voir aussi

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Définit les limites d'une zone qui doit être privilégiée dans les résultats. 

// Creates a Geocoder that prefers points in the area of Manhattan.
const geocoder = Maps.newGeocoder().setBounds(
    40.699642,
    -74.021072,
    40.877569,
    -73.908548,
);

Paramètres

NomTypeDescription
swLatitudeNumberlatitude de l'angle sud-ouest des limites
swLongitudeNumberLongitude du coin sud-ouest des limites
neLatitudeNumberlatitude du coin nord-est des limites
neLongitudeNumberLongitude du coin nord-est des limites

Renvois

Geocoder : objet Geocoder pour faciliter l'association en chaîne des appels

Voir aussi

setLanguage(language)

Définit la langue à utiliser dans les résultats. 

// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');

Paramètres

NomTypeDescription
languageStringun identifiant de langue BCP-47

Renvois

Geocoder : objet Geocoder permettant de faciliter l'association en chaîne des appels.

Voir aussi

setRegion(region)

Définit une région à utiliser lors de l'interprétation des noms de lieux. Les codes de région acceptés correspondent aux ccTLD acceptés par Google Maps. Par exemple, le code de région "uk" correspond à "maps.google.co.uk". 

// Creates a Geocoder with the region set to France.
const geocoder = Maps.newGeocoder().setRegion('fr');

Paramètres

NomTypeDescription
regionStringCode de région à utiliser

Renvois

Geocoder : objet Geocoder pour faciliter l'association en chaîne des appels

Voir aussi