Class ElevationSampler

ElevationSampler

특정 위치의 고도를 샘플링할 수 있습니다.
아래 예는 이 클래스를 사용하여 경로를 따라 가장 높은 지점을 결정하는 방법을 보여줍니다. 지도에 표시하고 Google Drive에 저장할 수 있습니다. 

// Get directions from Denver to Grand Junction.
var directions = Maps.newDirectionFinder()
    .setOrigin('Denver, CO')
    .setDestination('Grand Junction, CO')
    .setMode(Maps.DirectionFinder.Mode.DRIVING)
    .getDirections();
var route = directions.routes[0];

// Get elevation samples along the route.
var numberOfSamples = 30;
var response = Maps.newElevationSampler()
    .samplePath(route.overview_polyline.points, numberOfSamples)

// Determine highest point.
var maxElevation = Number.MIN_VALUE;
var highestPoint = null;
for (var i = 0; i < response.results.length; i++) {
  var sample = response.results[i];
  if (sample.elevation > maxElevation) {
    maxElevation = sample.elevation;
    highestPoint = sample.location;
  }
}

// Add the path and marker to a map.
var map = Maps.newStaticMap()
    .addPath(route.overview_polyline.points)
    .addMarker(highestPoint.lat, highestPoint.lng);

// Save the map to your drive
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

참고 항목

메서드

메서드반환 유형간략한 설명
sampleLocation(latitude, longitude)Object단일 점 (위도/경도)에 대한 고도 데이터를 반환합니다.
sampleLocations(points)Object일련의 지점 (위도/경도)에 대한 고도 데이터를 반환합니다.
sampleLocations(encodedPolyline)Object인코딩된 다중선에 있는 점에 대한 고도 데이터를 반환합니다.
samplePath(points, numSamples)Object일련의 점을 사용하여 정의된, 선에 있는 여러 샘플에 대한 고도 데이터를 반환합니다.
samplePath(encodedPolyline, numSamples)Object인코딩된 폴리라인을 사용하여 정의된, 선에 있는 여러 샘플에 대한 고도 데이터를 반환합니다.

자세한 문서

sampleLocation(latitude, longitude)

단일 점 (위도/경도)에 대한 고도 데이터를 반환합니다. 

// Gets the elevation of Times Square using a point.
var data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472);
Logger.log(data.results[0].elevation);

매개변수

이름유형설명
latitudeNumber샘플링할 점의 위도
longitudeNumber샘플링할 지점의 경도

리턴

Object: 여기에 설명된 고도 데이터가 포함된 JSON 객체

sampleLocations(points)

일련의 지점 (위도/경도)에 대한 고도 데이터를 반환합니다. 

// Gets the elevation of Times Square and Central Park using points.
var data = Maps.newElevationSampler().sampleLocations([
    // Times Square
    40.759011, -73.984472,
    // Central Park
    40.777052, -73.975464
]);
Logger.log('Times Square: ' + data.results[0].elevation);
Logger.log('Central Park: ' + data.results[1].elevation);

매개변수

이름유형설명
pointsNumber[]위도/경도 쌍의 배열

리턴

Object: 여기에 설명된 고도 데이터가 포함된 JSON 객체

sampleLocations(encodedPolyline)

인코딩된 다중선에 있는 점에 대한 고도 데이터를 반환합니다. 

// Gets the elevation of Times Square and Central Park using a polyline.
var data = Maps.newElevationSampler().sampleLocations('yvwwF|aqbMwoBiw@');
Logger.log('Times Square: ' + data.results[0].elevation);
Logger.log('Central Park: ' + data.results[1].elevation);

매개변수

이름유형설명
encodedPolylineString샘플링할 점의 인코딩된 폴리라인

리턴

Object: 여기에 설명된 고도 데이터가 포함된 JSON 객체

samplePath(points, numSamples)

일련의 점을 사용하여 정의된, 선에 있는 여러 샘플에 대한 고도 데이터를 반환합니다. 

// Gets the elevation of five points between Times Square and Central Park.
var data = Maps.newElevationSampler().samplePath([
    // Times Square
    40.759011, -73.984472,
    // Central Park
    40.777052, -73.975464
], 5);
for (var i = 0; i < data.results.length; i++) {
  Logger.log(data.results[i].elevation);
}

매개변수

이름유형설명
pointsNumber[]샘플링할 경로를 정의하는 위도/경도 쌍의 배열
numSamplesInteger점의 경로를 따라 샘플링할 점 수

리턴

Object: 여기에 설명된 고도 데이터가 포함된 JSON 객체

samplePath(encodedPolyline, numSamples)

인코딩된 폴리라인을 사용하여 정의된, 선에 있는 여러 샘플에 대한 고도 데이터를 반환합니다. 

// Gets the elevation of five points between Times Square and Central Park.
var data = Maps.newElevationSampler().samplePath('yvwwF|aqbMwoBiw@', 5);
for (var i = 0; i < data.results.length; i++) {
  Logger.log(data.results[i].elevation);
}

매개변수

이름유형설명
encodedPolylineString샘플링할 경로를 정의하는 점의 인코딩된 폴리라인
numSamplesInteger점의 경로를 따라 샘플링할 점 수

리턴

Object: 여기에 설명된 고도 데이터가 포함된 JSON 객체