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

ראה גם

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של הנקודה לדגימה
longitudeNumberקו האורך של הנקודה לדגימה

חזרה

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

פרמטרים

שםסוגתיאור
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 שמכיל את נתוני הגובה, כפי שמתואר כאן