Permite a conversão entre um endereço e coordenadas geográficas.
O exemplo abaixo mostra como usar essa classe para encontrar as nove principais correspondências para o local "Main St" no Colorado, adicioná-las a um mapa e incorporá-las a um novo arquivo do Documentos 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'));
Veja também
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
geocode(address) | Object | Extrai os pontos geográficos aproximados de um determinado endereço. |
reverseGeocode(latitude, longitude) | Object | Extrai os endereços aproximados de um determinado ponto geográfico. |
setBounds(swLatitude, swLongitude, neLatitude, neLongitude) | Geocoder | Define os limites de uma área que deve receber preferência extra nos resultados. |
setLanguage(language) | Geocoder | Define o idioma a ser usado nos resultados. |
setRegion(region) | Geocoder | Define uma região a ser usada ao interpretar nomes de locais. |
Documentação detalhada
geocode(address)
Extrai os pontos geográficos aproximados de um determinado endereço.
// 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
Nome | Tipo | Descrição |
---|---|---|
address | String | um endereço |
Retorno
Object
: um objeto JSON contendo os dados de geocodificação, conforme descrito aqui.
reverseGeocode(latitude, longitude)
Extrai os endereços aproximados de um determinado ponto geográfico.
// 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
Nome | Tipo | Descrição |
---|---|---|
latitude | Number | a latitude do ponto |
longitude | Number | a longitude do ponto |
Retorno
Object
: um objeto JSON contendo os dados de geocodificação inversa, conforme descrito aqui.
Veja também
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)
Define os limites de uma área que deve receber preferência extra nos 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
Nome | Tipo | Descrição |
---|---|---|
swLatitude | Number | a latitude do canto sudoeste dos limites |
swLongitude | Number | a longitude do canto sudoeste dos limites |
neLatitude | Number | a latitude do canto nordeste dos limites |
neLongitude | Number | a longitude do canto nordeste dos limites |
Retorno
Geocoder
: o objeto Geocoder para facilitar o encadeamento de chamadas.
Veja também
setLanguage(language)
Define o idioma a ser usado nos resultados.
// Creates a Geocoder with the language set to French. var geocoder = Maps.newGeocoder().setLanguage('fr');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
language | String | um identificador de idioma BCP-47; |
Retorno
Geocoder
: o objeto Geocoder para facilitar o encadeamento de chamadas.
Veja também
setRegion(region)
Define uma região a ser usada ao interpretar nomes de locais. Os códigos de região aceitos correspondem aos ccTLDs aceitos no Google Maps. Por exemplo, o 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
Nome | Tipo | Descrição |
---|---|---|
region | String | o código da região a ser usado |
Retorno
Geocoder
: o objeto Geocoder para facilitar o encadeamento de chamadas.