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" au Colorado, les ajouter à une carte, puis l'intégrer dans un nouveau document Google Docs. 

// 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)ObjectObtient les points géographiques approximatifs pour une adresse donnée.
reverseGeocode(latitude, longitude)ObjectRécupère les adresses approximatives pour un point géographique donné.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDéfinit les limites d'une zone à laquelle une préférence supplémentaire doit être accordé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)

Obtient les points géographiques approximatifs pour 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 pour 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
latitudeNumberLatitude du point.
longitudeNumberLongitude du point.

Renvois

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

Voir aussi

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Définit les limites d'une zone à laquelle une préférence supplémentaire doit être accordé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 de l'angle sud-ouest des limites.
neLatitudeNumberLatitude de l'angle nord-est des limites.
neLongitudeNumberLongitude de l'angle 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
languageStringIdentifiant de langue BCP-47.

Renvois

Geocoder : objet Geocoder pour 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 régional "fr" correspond à "maps.google.fr". 

// 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