Class Geocoder

Геокодер

Позволяет преобразовывать адрес в географические координаты.
В приведенном ниже примере показано, как с помощью этого класса можно найти девять лучших совпадений для местоположения «Главная улица» в Колорадо, добавить их на карту, а затем встроить ее в новый документ Google Docs.

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

См. также

Методы

Метод Тип возвращаемого значения Краткое описание
geocode(address) Object Получает приблизительные географические точки для заданного адреса.
reverse Geocode(latitude, longitude) Object Получает приблизительные адреса для заданной географической точки.
set Bounds(swLatitude, swLongitude, neLatitude, neLongitude) Geocoder Задает границы области, которой следует отдать приоритет в результатах поиска.
set Language(language) Geocoder Задает язык, который будет использоваться в результатах.
set Region(region) Geocoder Задает регион, используемый при интерпретации названий местоположений.

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

geocode(address)

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

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

Параметры

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

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

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

reverse Geocode(latitude, longitude)

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

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

Параметры

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

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

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

См. также

set Bounds(swLatitude, swLongitude, neLatitude, neLongitude)

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

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

Параметры

Имя Тип Описание
sw Latitude Number Широта юго-западного угла границ.
sw Longitude Number Долгота юго-западного угла границ.
ne Latitude Number Широта северо-восточного угла границ.
ne Longitude Number Долгота северо-восточного угла границ.

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

Geocoder — объект Geocoder, облегчающий цепочку вызовов.

См. также

set Language(language)

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

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

Параметры

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

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

Geocoder — объект Geocoder, облегчающий цепочку вызовов.

См. также

set Region(region)

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

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

Параметры

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

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

Geocoder — объект Geocoder, облегчающий цепочку вызовов.

См. также