Class DirectionFinder

DirectionFinder

위치 간의 경로를 검색할 수 있습니다.
아래 예는 이 클래스를 사용하여 타임 스퀘어에서 다음 목적지까지 가는 길을 찾는 방법을 보여줍니다. 먼저 링컨 센터에 정차한 센트럴 파크가 위치와 경로를 지도에 표시하고 이메일로 보낼 수 있습니다

// Get the directions.
var 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();
var route = directions.routes[0];

// Set up marker styles.
var markerSize = Maps.StaticMap.MarkerSize.MID;
var markerColor = Maps.StaticMap.Color.GREEN
var markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
var map = Maps.newStaticMap();
for (var i = 0; i < route.legs.length; i++) {
  var leg = route.legs[i];
  if (i == 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(markerSize, markerColor, 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.
var 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')
    }
  }
);

참고 항목

메서드

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

자세한 문서

addWaypoint(latitude, longitude)

점 (위도/경도)을 사용하여 경로가 통과해야 하는 경유지를 추가합니다.

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

매개변수

이름유형설명
latitudeNumber경유지의 위도입니다.
longitudeNumber경유지의 경도입니다.

리턴

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


addWaypoint(address)

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

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

매개변수

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

리턴

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


clearWaypoints()

현재 경유지 집합을 삭제합니다.

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

참고 항목


setAlternatives(useAlternatives)

순위가 가장 높은 경로 대신 대체 경로를 반환할지 여부를 설정합니다. route (기본값은 false)입니다. true인 경우 결과 객체의 routes 배열은 여러 개의 항목이 있습니다.

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

매개변수

이름유형설명
useAlternativesBoolean대체 경로를 반환하려면 true, 그렇지 않은 경우 false를 반환

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체


setArrive(time)

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

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

매개변수

이름유형설명
timeDate도착 시간

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목


setAvoid(avoid)

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

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

매개변수

이름유형설명
avoidStringAvoid의 상수 값

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목


setDepart(time)

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

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

매개변수

이름유형설명
timeDate출발 시간

리턴

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

참고 항목


setDestination(latitude, longitude)

점 (위도/경도)을 사용하여 경로를 계산할 도착 위치를 설정합니다.

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

매개변수

이름유형설명
latitudeNumber목적지의 위도
longitudeNumber목적지의 경도

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체


setDestination(address)

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

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

매개변수

이름유형설명
addressString도착지 주소

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체


setLanguage(language)

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

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

매개변수

이름유형설명
languageStringBCP-47 언어 식별자

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목


setMode(mode)

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

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

매개변수

이름유형설명
modeStringMode의 상수 값

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목


setOptimizeWaypoints(optimizeOrder)

경유지를 더 많은 지점으로 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다. 효율적입니다 (기본값은 false임).

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

매개변수

이름유형설명
optimizeOrderBoolean순서를 최적화하려면 true, 그렇지 않으면 false를 반환합니다.

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목


setOrigin(latitude, longitude)

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

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

매개변수

이름유형설명
latitudeNumber출발지의 위도
longitudeNumber출발지의 경도

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체


setOrigin(address)

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

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

매개변수

이름유형설명
addressString출발지 주소

리턴

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


setRegion(region)

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

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

매개변수

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

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목