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

כדאי לעיין גם בפרטים הבאים

• 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.
var 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.
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);

פרמטרים

שם	תיאור	התיאור
points	Number[]	מערך של צמדים של קווי אורך ורוחב

החזרות

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

פרמטרים

שם	תיאור	התיאור
encodedPolyline	String	שורה מקודדת של נקודות לדוגמה

החזרות

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

פרמטרים

שם	תיאור	התיאור
points	Number[]	מערך של צמדי קו רוחב/אורך המגדירים נתיב לדגימת נתונים
numSamples	Integer	מספר הנקודות שצריך לדגום לאורך נתיב הנקודות

החזרות

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

פרמטרים

שם	תיאור	התיאור
encodedPolyline	String	קו פוליגוני מקודד של נקודות המגדיר נתיב לדגימה
numSamples	Integer	מספר הנקודות שצריך לדגום לאורך נתיב הנקודות

החזרות

Object - אובייקט JSON שמכיל את נתוני הגובה, כפי שמתואר כאן