Class Geocoder

지오코더

주소와 지리적 좌표 간의 변환을 허용합니다.
아래 예에서는 이 클래스를 사용하여 콜로라도의 'Main St' 위치와 일치하는 상위 9개 항목을 찾아 지도에 추가한 후 새 Google 문서에 삽입하는 방법을 보여줍니다.

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

참고 항목

• Google Geocoding API

메서드

메서드	반환 유형	간략한 설명
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.
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 객체입니다.

---

reverseGeocode(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 객체입니다.

참고 항목

• Google Geocoding API

---

setBounds(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,
);

매개변수

이름	유형	설명
swLatitude	Number	경계의 남서쪽 모서리의 위도
swLongitude	Number	경계의 남서쪽 모서리의 경도
neLatitude	Number	경계의 북동쪽 모서리의 위도
neLongitude	Number	경계의 북동쪽 모서리의 경도

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체

참고 항목

• Google Geocoding API

---

setLanguage(language)

결과에 사용할 언어를 설정합니다.

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

매개변수

이름	유형	설명
language	String	BCP-47 언어 식별자

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체입니다.

참고 항목

• 인코딩된 폴리라인 형식

---

setRegion(region)

위치 이름을 해석할 때 사용할 지역을 설정합니다. 지원되는 지역 코드는 Google 지도에서 지원되는 ccTLD에 해당합니다. 예를 들어 지역 코드 'uk'는 'maps.google.co.uk'에 해당합니다.

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

매개변수

이름	유형	설명
region	String	사용할 지역 코드

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체

참고 항목

• Google Geocoding API