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

ראה גם

שיטות

שיטהסוג הערך המוחזרתיאור קצר
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.
var 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.
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);

פרמטרים

שםסוגתיאור
pointsNumber[]מערך של זוגות קו רוחב/קו אורך

חזרה

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

פרמטרים

שםסוגתיאור
encodedPolylineStringקו פוליגוני מקודד של נקודות לדגימה

חזרה

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

פרמטרים

שםסוגתיאור
pointsNumber[]מערך של זוגות של קו רוחב/קו אורך שמגדירים נתיב לדגימה
numSamplesIntegerמספר הנקודות שיש לדגום לאורך הנתיב של הנקודות

חזרה

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

פרמטרים

שםסוגתיאור
encodedPolylineStringקו פוליגוני מקודד של נקודות שמגדיר נתיב לדגימה
numSamplesIntegerמספר הנקודות שיש לדגום לאורך הנתיב של הנקודות

חזרה

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