Class Geocoder

Geocoder

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étodoTipo de retornoBreve descrição
geocode(address)ObjectExtrai os pontos geográficos aproximados de um determinado endereço.
reverseGeocode(latitude, longitude)ObjectExtrai os endereços aproximados de um determinado ponto geográfico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDefine os limites de uma área que deve receber preferência extra nos resultados.
setLanguage(language)GeocoderDefine o idioma a ser usado nos resultados.
setRegion(region)GeocoderDefine 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

NomeTipoDescrição
addressStringum 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

NomeTipoDescrição
latitudeNumbera latitude do ponto
longitudeNumbera 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

NomeTipoDescrição
swLatitudeNumbera latitude do canto sudoeste dos limites
swLongitudeNumbera longitude do canto sudoeste dos limites
neLatitudeNumbera latitude do canto nordeste dos limites
neLongitudeNumbera 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

NomeTipoDescrição
languageStringum 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

NomeTipoDescrição
regionStringo código da região a ser usado

Retorno

Geocoder: o objeto Geocoder para facilitar o encadeamento de chamadas.

Veja também