Class Geocoder

Geocoder

Permite la conversión entre una dirección y coordenadas geográficas.
En el siguiente ejemplo, se muestra cómo puedes usar 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.
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'));

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	Establece el idioma que se usará en los resultados.
setRegion(region)	Geocoder	Establece una región para usar cuando se interpreten 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.
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,
  );
}

Parámetros

Nombre	Tipo	Descripción
address	String	una dirección

Volver

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.
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,
  );
}

Parámetros

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

Volver

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.
const geocoder = Maps.newGeocoder().setBounds(
    40.699642,
    -74.021072,
    40.877569,
    -73.908548,
);

Parámetros

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

Volver

Geocoder: Es el objeto Geocoder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Geocoding

---

setLanguage(language)

Establece el idioma que se usará en los resultados.

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

Parámetros

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

Volver

Geocoder: Es el objeto Geocoder para facilitar el encadenamiento de llamadas.

Consulta también

• Formato de polilínea codificada

---

setRegion(region)

Establece una región para usar cuando se interpreten los nombres de las ubicaciones. Los códigos de región admitidos corresponden a los ccTLD que admite Google Maps. Por ejemplo, el código de región "uk" corresponde a "maps.google.co.uk".

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

Parámetros

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

Volver

Geocoder: Es el objeto Geocoder para facilitar el encadenamiento de llamadas.

Consulta también

• API de Google Geocoding