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

پارامترها

نام تایپ کنید توضیحات
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 حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است