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