Class Geocoder

Геокодер

Позволяет преобразовать адрес в географические координаты.
В приведенном ниже примере показано, как с помощью этого класса можно найти девять лучших совпадений для местоположения «Мейн-стрит» в Колорадо, добавить их на карту, а затем встроить в новый документ 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'));

Смотрите также

Методы

Метод Тип возврата Краткое описание
geocode(address) Object Получает приблизительные географические точки для заданного адреса.
reverseGeocode(latitude, longitude) Object Получает приблизительные адреса для заданной географической точки.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude) Geocoder Устанавливает границы области, которой следует отдать предпочтение в результатах.
setLanguage(language) Geocoder Устанавливает язык, который будет использоваться в результатах.
setRegion(region) Geocoder Устанавливает регион для использования при интерпретации названий местоположений.

Подробная документация

geocode(address)

Получает приблизительные географические точки для заданного адреса.

// 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);
}

Параметры

Имя Тип Описание
address String адрес

Возвращаться

Object — объект JSON, содержащий данные геокодирования, как описано здесь .

reverseGeocode(latitude, longitude)

Получает приблизительные адреса для заданной географической точки.

// 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);
}

Параметры

Имя Тип Описание
latitude Number широта точки
longitude Number долгота точки

Возвращаться

Object — объект JSON, содержащий данные обратного геокодирования, как описано здесь .

Смотрите также

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Устанавливает границы области, которой следует отдать предпочтение в результатах.

// Creates a Geocoder that prefers points in the area of Manhattan.
var geocoder = Maps.newGeocoder()
    .setBounds(40.699642, -74.021072, 40.877569, -73.908548);

Параметры

Имя Тип Описание
swLatitude Number широта юго-западного угла границы
swLongitude Number долгота юго-западного угла границы
neLatitude Number широта северо-восточного угла границы
neLongitude Number долгота северо-восточного угла границы

Возвращаться

Geocoder — объект Geocoder для облегчения цепочки вызовов.

Смотрите также

setLanguage(language)

Устанавливает язык, который будет использоваться в результатах.

// Creates a Geocoder with the language set to French.
var geocoder = Maps.newGeocoder().setLanguage('fr');

Параметры

Имя Тип Описание
language String идентификатор языка BCP-47

Возвращаться

Geocoder — объект Geocoder для облегчения объединения вызовов в цепочку.

Смотрите также

setRegion(region)

Устанавливает регион для использования при интерпретации названий местоположений. Поддерживаемые коды регионов соответствуют ccTLD, поддерживаемым Google Maps. Например, код региона «uk» соответствует «maps.google.co.uk».

// Creates a Geocoder with the region set to France.
var geocoder = Maps.newGeocoder().setRegion('fr');

Параметры

Имя Тип Описание
region String код региона для использования

Возвращаться

Geocoder — объект Geocoder для облегчения цепочки вызовов.

Смотрите также