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

Métodos

MétodoTipo de datos que se muestraDescripción breve
geocode(address)ObjectObtiene los puntos geográficos aproximados de una dirección determinada.
reverseGeocode(latitude, longitude)ObjectObtiene las direcciones aproximadas de 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 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

NombreTipoDescripción
addressStringuna 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

NombreTipoDescripción
latitudeNumberla latitud del punto
longitudeNumberla longitud del punto

Volver

Object: Es un objeto JSON que contiene los datos de geocodificación 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
swLatitudeNumberla latitud de la esquina suroeste de los límites
swLongitudeNumberla longitud de la esquina suroeste de los límites
neLatitudeNumberla latitud de la esquina noreste de los límites
neLongitudeNumberla 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
languageStringUn 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 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

NombreTipoDescripción
regionStringel código de región que se usará

Volver

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

Consulta también