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 liftion 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.
var 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.
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 שמכיל את נתוני הגובה כפי שמתואר כאן