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'),
);

另请参阅

• Google Elevation API

方法

方法	返回类型	简介
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.
const data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472);
Logger.log(data.results[0].elevation);

参数

名称	类型	说明
latitude	Number	要采样的点的纬度
longitude	Number	要采样的点的经度

返回

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}`);

参数

名称	类型	说明
points	Number[]	纬度/经度对数组

返回

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}`);

参数

名称	类型	说明
encodedPolyline	String	要采样的点的编码多段线

返回

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);
}

参数

名称	类型	说明
points	Number[]	一个纬度/经度对数组，用于定义要对其进行抽样的路径
numSamples	Integer	要沿点路径采样的点数

返回

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);
}

参数

名称	类型	说明
encodedPolyline	String	定义要采样的路径的点的编码多段线
numSamples	Integer	要沿点路径采样的点数

返回

Object - 包含海拔数据的 JSON 对象，如此处所述