דף זה תורגם על ידי Cloud Translation API.

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