หน้านี้ได้รับการแปลโดย Cloud Translation API

Class 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`	แสดงผลข้อมูลระดับความสูงของจุดเดียว (lat/lng)
`sampleLocations(points)`	`Object`	แสดงผลข้อมูลระดับความสูงของชุดจุด (lat/lng)
`sampleLocations(encodedPolyline)`	`Object`	แสดงผลข้อมูลระดับความสูงของจุดในเส้นประกอบที่เข้ารหัส
`samplePath(points, numSamples)`	`Object`	แสดงผลข้อมูลระดับความสูงของตัวอย่างจำนวนหนึ่งตามเส้นที่กำหนดโดยใช้ชุดจุด
`samplePath(encodedPolyline, numSamples)`	`Object`	แสดงผลข้อมูลระดับความสูงของตัวอย่างจำนวนหนึ่งตามเส้นที่กำหนดโดยใช้เส้นประกอบที่เข้ารหัส

เอกสารประกอบโดยละเอียด

`sampleLocation(latitude, longitude)`

แสดงข้อมูลระดับความสูงของจุดเดียว (lat/lng)

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

แสดงผลข้อมูลระดับความสูงของชุดจุด (lat/lng)

// 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 ที่มีข้อมูลระดับความสูงตามที่อธิบายไว้ที่นี่