Class ElevationSampler

ElevationSampler

可在特定位置取樣高度。
以下範例說明如何使用這個類別，判斷從丹佛到科羅拉多州大峽谷的路線沿途最高點，並將地圖繪製在地圖上，然後將地圖儲存到 Google 雲端硬碟。

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

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

// Determine highest point.

let highestLocation = null;
let highestElevation = Number.MIN_VALUE;
for (const sample of response.results) {
  if (sample.elevation > highestElevation) {
    highestElevation = sample.elevation;
    highestLocation = sample.location;
  }
}

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

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

另請參閱

方法

方法傳回類型簡短說明
sampleLocation(latitude, longitude)Object傳回單一點 (lat/lng) 的海拔高度資料。
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.
const 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.
const 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.
const 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.
const data = Maps.newElevationSampler().samplePath(
    [
      // Times Square
      40.759011,
      -73.984472,
      // Central Park
      40.777052,
      -73.975464,
    ],
    5,
);
for (let 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.
const data = Maps.newElevationSampler().samplePath('yvwwF|aqbMwoBiw@', 5);
for (let i = 0; i < data.results.length; i++) {
  Logger.log(data.results[i].elevation);
}

參數

名稱類型說明
encodedPolylineString定義要取樣的路徑的點組成的編碼折線
numSamplesInteger沿著點路徑取樣的點數

回攻員

Object：包含海拔高度資料的 JSON 物件，如這裡所述