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, incorporarlo 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

Métodos

MétodoTipo de datos que se muestraDescripción breve
geocode(address)ObjectObtiene los puntos geográficos aproximados para una dirección determinada.
reverseGeocode(latitude, longitude)ObjectObtiene las direcciones aproximadas para un punto geográfico determinado.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderEstablece los límites de un área a la que se le debe dar preferencia adicional en los resultados.
setLanguage(language)GeocoderEstablece el idioma que se usará en los resultados.
setRegion(region)GeocoderEstablece una región para usar cuando se interpreten nombres de ubicaciones.

Documentación detallada

geocode(address)

Obtiene los puntos geográficos aproximados para 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

NombreTipoDescripción
addressStringEs 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 para 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

NombreTipoDescripción
latitudeNumberEs la latitud del punto.
longitudeNumberEs la longitud del punto.

Volver

Object: Es un objeto JSON que contiene los datos de la codificación geográfica inversa, como se describe aquí.

Consulta también

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

NombreTipoDescripción
swLatitudeNumberEs la latitud de la esquina suroeste de los límites.
swLongitudeNumberEs la longitud de la esquina sudoeste de los límites.
neLatitudeNumberEs la latitud de la esquina noreste de los límites.
neLongitudeNumberEs 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

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

NombreTipoDescripción
languageStringEs un identificador de idioma BCP-47.

Volver

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

Consulta también

setRegion(region)

Establece una región para usar cuando se interpreten nombres de 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

NombreTipoDescripción
regionStringEs el código de región que se usará.

Volver

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

Consulta también