Se usó la API de Cloud Translation para traducir esta página.

Class Geocoder

Permite la conversión de una dirección a coordenadas geográficas.
En el siguiente ejemplo, se muestra cómo puedes utilizar esta clase para encontrar las nueve coincidencias principales de la ubicación "Main St" en Colorado, agregarlas a un mapa y, luego, incorporarlas en un nuevo documento de Google.

// Find the best matches for "Main St" in Colorado.
var 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.
var doc = DocumentApp.create('My Map');
var map = Maps.newStaticMap();

// Add each result to the map and doc.
for (var i = 0; i < response.results.length && i < 9; i++) {
  var 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'));

Consulta también

API de Google Geocoding

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`geocode(address)`	`Object`	Obtiene los puntos geográficos aproximados de una dirección determinada.
`reverseGeocode(latitude, longitude)`	`Object`	Obtiene las direcciones aproximadas de un punto geográfico determinado.
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	establece los límites de un área a la que se le debe dar preferencia adicional en los resultados.
`setLanguage(language)`	`Geocoder`	Configura el idioma que se usará en los resultados.
`setRegion(region)`	`Geocoder`	Configura una región para interpretar los nombres de las ubicaciones.

Documentación detallada

`geocode(address)`

Obtiene los puntos geográficos aproximados de una dirección determinada.

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

Parámetros

Nombre	Tipo	Descripción
`address`	`String`	una dirección

Devolvedor

Object: Es un objeto JSON que contiene los datos de geocodificación, como se describe aquí.

`reverseGeocode(latitude, longitude)`

Obtiene las direcciones aproximadas de un punto geográfico determinado.

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

Parámetros

Nombre	Tipo	Descripción
`latitude`	`Number`	la latitud del punto
`longitude`	`Number`	la longitud del punto

Devolvedor

Object: Es un objeto JSON que contiene los datos de geocodificación inversa, como se describe aquí.

Consulta también

API de Google Geocoding

`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`

establece los límites de un área a la que se le debe dar preferencia adicional en los resultados.

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

Parámetros

Nombre	Tipo	Descripción
`swLatitude`	`Number`	la latitud del ángulo suroeste de los límites
`swLongitude`	`Number`	la longitud del ángulo suroeste de los límites
`neLatitude`	`Number`	la latitud de la esquina noreste de los límites
`neLongitude`	`Number`	la longitud del ángulo noreste de los límites

Devolvedor

Geocoder: Es el objeto Geocoder que facilita el encadenamiento de llamadas.

Consulta también

API de Google Geocoding

`setLanguage(language)`

Configura el idioma que se usará en los resultados.

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

Parámetros

Nombre	Tipo	Descripción
`language`	`String`	un identificador de idioma BCP-47

Devolvedor

Geocoder: Es el objeto Geocoder que facilita el encadenamiento de llamadas.

Consulta también

Formato de polilínea codificada

`setRegion(region)`

Configura una región para interpretar los nombres de las ubicaciones. Los códigos de región admitidos corresponden a los ccTLD admitidos por Google Maps. Por ejemplo, el código regional "uk" corresponde a "maps.google.co.uk".

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

Parámetros

Nombre	Tipo	Descripción
`region`	`String`	el código de región que se usará

Devolvedor

Geocoder: Es el objeto Geocoder que facilita el encadenamiento de llamadas.

Consulta también

API de Google Geocoding