Class ElevationSampler

Sampler של גובה

מאפשרת לדגום גובה במיקומים ספציפיים.
בדוגמה הבאה מוסבר איך משתמשים בכיתה הזו כדי לקבוע את הנקודה הגבוהה ביותר לאורך המסלול מ-Denver ל-Grand Junction בקולורדו, להציג אותה במפה ולשמור את המפה ב-Google Drive.

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
sampleLocation(latitude, longitude)	Object	הפונקציה מחזירה נתוני גובה של נקודה אחת (קו הרוחב/קו האורך).
sampleLocations(points)	Object	הפונקציה מחזירה נתוני גובה של סדרת נקודות (lat/lng).
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)

הפונקציה מחזירה נתוני גובה של סדרת נקודות (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 שמכיל את נתוני הגובה, כפי שמתואר כאן