Class ElevationSampler

نمونه بردار ارتفاع

امکان نمونه برداری از ارتفاعات در مکان های خاص را فراهم می کند.
مثال زیر نشان می دهد که چگونه می توانید از این کلاس برای تعیین بالاترین نقطه در طول مسیر از دنور به گرند جانکشن در کلرادو استفاده کنید، آن را روی نقشه ترسیم کنید و نقشه را در 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'),
);

همچنین ببینید

• Google Elevation API

روش ها

روش	نوع برگشت	شرح مختصر
sample Location(latitude, longitude)	Object	داده های ارتفاع را برای یک نقطه (lat/lng) برمی گرداند.
sample Locations(points)	Object	داده های ارتفاع را برای یک سری نقاط (lat/lng) برمی گرداند.
sample Locations(encodedPolyline)	Object	داده های ارتفاع برای نقاط در یک چند خط کدگذاری شده را برمی گرداند.
sample Path(points, numSamples)	Object	داده های ارتفاع را برای تعدادی از نمونه ها در امتداد یک خط، که با استفاده از یک سری نقاط تعریف شده اند، برمی گرداند.
sample Path(encodedPolyline, numSamples)	Object	داده های ارتفاع را برای تعدادی از نمونه ها در امتداد یک خط، که با استفاده از یک چند خط کدگذاری شده تعریف شده اند، برمی گرداند.

مستندات دقیق

sample Location(latitude, longitude)

داده های ارتفاع را برای یک نقطه (lat/lng) برمی گرداند.

// Gets the elevation of Times Square using a point.
const data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472);
Logger.log(data.results[0].elevation);

پارامترها

نام	تایپ کنید	توضیحات
latitude	Number	عرض جغرافیایی نقطه به نمونه
longitude	Number	طول جغرافیایی نقطه به نمونه

بازگشت

Object - یک شی JSON حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است

---

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

پارامترها

نام	تایپ کنید	توضیحات
points	Number[]	آرایه ای از جفت طول و عرض جغرافیایی

بازگشت

Object - یک شی JSON حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است

---

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

پارامترها

نام	تایپ کنید	توضیحات
encoded Polyline	String	چند خط کدگذاری شده از نقاط به نمونه

بازگشت

Object - یک شی JSON حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است

---

sample Path(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);
}

پارامترها

نام	تایپ کنید	توضیحات
points	Number[]	آرایه ای از جفت طول و عرض جغرافیایی که مسیری را برای نمونه برداری تعریف می کند
num Samples	Integer	تعداد نقاط نمونه در طول مسیر نقاط

بازگشت

Object - یک شی JSON حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است

---

sample Path(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);
}

پارامترها

نام	تایپ کنید	توضیحات
encoded Polyline	String	چند خط کدگذاری شده از نقاط که مسیری را برای نمونه برداری تعریف می کند
num Samples	Integer	تعداد نقاط نمونه در طول مسیر نقاط

بازگشت

Object - یک شی JSON حاوی داده های ارتفاع، همانطور که در اینجا توضیح داده شده است