이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class DirectionFinder

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

// 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