Class DirectionFinder

방향Finder

위치 간의 경로를 검색할 수 있습니다.
아래 예에서는 이 클래스를 사용하여 타임스 스퀘어에서 센트럴 파크까지 가는 경로를 확인하고, 먼저 링컨 센터에 들른 후, 지도에 위치와 경로를 표시하고, 이메일로 지도를 보내는 방법을 보여줍니다.

// Get the directions.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Times Square, New York, NY')
                       .addWaypoint('Lincoln Center, New York, NY')
                       .setDestination('Central Park, New York, NY')
                       .setMode(Maps.DirectionFinder.Mode.DRIVING)
                       .getDirections();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      String.fromCharCode(markerLetterCode),
  );
  map.addMarker(leg.end_location.lat, leg.end_location.lng);
  markerLetterCode++;
}

// Add a path for the entire route.
map.addPath(route.overview_polyline.points);

// Send the map in an email.
const toAddress = Session.getActiveUser().getEmail();
MailApp.sendEmail(
    toAddress,
    'Directions',
    `Please open: ${map.getMapUrl()}&key=YOUR_API_KEY`,
    {
      htmlBody: 'See below.<br/><img src="cid:mapImage">',
      inlineImages: {
        mapImage: Utilities.newBlob(map.getMapImage(), 'image/png'),
      },
    },
);

참고 항목

• Google Directions API

메서드

메서드	반환 유형	간략한 설명
addWaypoint(latitude, longitude)	DirectionFinder	지점 (lat/lng)을 사용하여 경로가 통과해야 하는 경로 지점을 추가합니다.
addWaypoint(address)	DirectionFinder	주소를 사용하여 경로가 통과해야 하는 중간 지점을 추가합니다.
clearWaypoints()	DirectionFinder	현재 웨이포인트 세트를 지웁니다.
getDirections()	Object	출발지, 도착지, 설정된 기타 옵션을 사용하여 경로를 가져옵니다.
setAlternatives(useAlternatives)	DirectionFinder	순위가 가장 높은 경로만 반환하는 대신 대체 경로를 반환할지 여부를 설정합니다 (기본값은 false).
setArrive(time)	DirectionFinder	원하는 도착 시간을 설정합니다 (해당하는 경우).
setAvoid(avoid)	DirectionFinder	특정 유형의 제한을 피할지 여부를 설정합니다.
setDepart(time)	DirectionFinder	원하는 출발 시간을 설정합니다 (해당하는 경우).
setDestination(latitude, longitude)	DirectionFinder	지점 (lat/lng)을 사용하여 경로를 계산할 종료 위치를 설정합니다.
setDestination(address)	DirectionFinder	주소를 사용하여 경로를 계산할 종료 위치를 설정합니다.
setLanguage(language)	DirectionFinder	경로에 사용할 언어를 설정합니다.
setMode(mode)	DirectionFinder	이동 수단을 설정합니다 (기본값: 운전).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	더 효율적인 순서로 경유지를 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다 (기본값: false).
setOrigin(latitude, longitude)	DirectionFinder	지점 (lat/lng)을 사용하여 경로를 계산할 시작 위치를 설정합니다.
setOrigin(address)	DirectionFinder	주소를 사용하여 경로를 계산할 시작 위치를 설정합니다.
setRegion(region)	DirectionFinder	위치 이름을 해석할 때 사용할 지역을 설정합니다.

자세한 문서

addWaypoint(latitude, longitude)

지점 (lat/lng)을 사용하여 경로가 통과해야 하는 경로 지점을 추가합니다.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    40.772628,
    -73.984243,
);

매개변수

이름	유형	설명
latitude	Number	웨이포인트의 위도입니다.
longitude	Number	웨이포인트의 경도입니다.

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체입니다.

---

addWaypoint(address)

주소를 사용하여 경로가 통과해야 하는 중간 지점을 추가합니다.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

매개변수

이름	유형	설명
address	String	주소입니다.

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체입니다.

---

clearWaypoints()

현재 웨이포인트 세트를 지웁니다.

const directionFinder = Maps.newDirectionFinder();
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

---

getDirections()

출발지, 도착지, 설정된 기타 옵션을 사용하여 경로를 가져옵니다.

// Logs how long it would take to walk from Times Square to Central Park.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Times Square, New York, NY')
                       .setDestination('Central Park, New York, NY')
                       .setMode(Maps.DirectionFinder.Mode.WALKING)
                       .getDirections();
Logger.log(directions.routes[0].legs[0].duration.text);

리턴

Object: 여기에 설명된 대로 경로의 경로 집합이 포함된 JSON 객체입니다.

참고 항목

• Google Directions API

---

setAlternatives(useAlternatives)

순위가 가장 높은 경로만 반환하는 대신 대체 경로를 반환할지 여부를 설정합니다 (기본값은 false). 이 값이 true이면 결과 객체의 routes 배열에 여러 항목이 포함될 수 있습니다.

// Creates a DirectionFinder with alternative routes enabled.
const directionFinder = Maps.newDirectionFinder().setAlternatives(true);

매개변수

이름	유형	설명
useAlternatives	Boolean	대체 경로를 반환하는 경우 true, 그렇지 않으면 false

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

---

setArrive(time)

원하는 도착 시간을 설정합니다 (해당하는 경우).

// Creates a DirectionFinder with an arrival time of 2 hours from now.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

매개변수

이름	유형	설명
time	Date	도착 시간

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setAvoid(avoid)

특정 유형의 제한을 피할지 여부를 설정합니다.

// Creates a DirectionFinder that avoid highways.
const directionFinder = Maps.newDirectionFinder().setAvoid(
    Maps.DirectionFinder.Avoid.HIGHWAYS,
);

매개변수

이름	유형	설명
avoid	String	Avoid의 상수 값

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setDepart(time)

원하는 출발 시간을 설정합니다 (해당하는 경우).

// Creates a DirectionFinder with a departure time of 1 hour from now.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

매개변수

이름	유형	설명
time	Date	출발 시간

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체입니다.

참고 항목

• Google Directions API

---

setDestination(latitude, longitude)

지점 (lat/lng)을 사용하여 경로를 계산할 종료 위치를 설정합니다.

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    40.777052,
    -73.975464,
);

매개변수

이름	유형	설명
latitude	Number	종료 위치의 위도
longitude	Number	종료 위치의 경도

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

---

setDestination(address)

주소를 사용하여 경로를 계산할 종료 위치를 설정합니다.

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

매개변수

이름	유형	설명
address	String	종료 주소

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

---

setLanguage(language)

경로에 사용할 언어를 설정합니다.

// Creates a DirectionFinder with the language set to French.
const directionFinder = Maps.newDirectionFinder().setLanguage('fr');

매개변수

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

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Maps API의 언어 지원

---

setMode(mode)

이동 수단을 설정합니다 (기본값: 운전).

// Creates a DirectionFinder with the mode set to walking.
const directionFinder = Maps.newDirectionFinder().setMode(
    Maps.DirectionFinder.Mode.WALKING,
);

매개변수

이름	유형	설명
mode	String	Mode의 상수 값

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

더 효율적인 순서로 경유지를 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다 (기본값: false).

// Creates a DirectionFinder with wapoint optimization enabled.
const directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

매개변수

이름	유형	설명
optimizeOrder	Boolean	순서를 최적화하려면 true, 그렇지 않으면 false

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setOrigin(latitude, longitude)

지점 (lat/lng)을 사용하여 경로를 계산할 시작 위치를 설정합니다.

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    40.759011,
    -73.984472,
);

매개변수

이름	유형	설명
latitude	Number	출발 위치의 위도
longitude	Number	출발 위치의 경도

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

---

setOrigin(address)

주소를 사용하여 경로를 계산할 시작 위치를 설정합니다.

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    'Times Square, New York, NY',
);

매개변수

이름	유형	설명
address	String	시작 주소

리턴

DirectionFinder: 호출 체이닝을 용이하게 하는 DirectionFinder 인스턴스

---

setRegion(region)

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

// Creates a DirectionFinder with the region set to France.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

매개변수

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

리턴

DirectionFinder - 호출 체이닝을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API