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 Elevation

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
sampleLocation(latitude, longitude)	Object	لعرض بيانات الارتفاع لنقطة واحدة (خط الطول/خط العرض).
sampleLocations(points)	Object	لعرض بيانات الارتفاع لسلسلة من النقاط (خط الطول/خط العرض).
sampleLocations(encodedPolyline)	Object	تعرض بيانات الارتفاع للنقاط في خط متعدد مرمّز.
samplePath(points, numSamples)	Object	لعرض بيانات الارتفاع لعدد من العينات على طول خط، محددة باستخدام سلسلة من النقاط.
samplePath(encodedPolyline, numSamples)	Object	لعرض بيانات الارتفاع لعدد من العينات على طول خط، تم تحديدها باستخدام خط متعدد مرمّز.

الوثائق التفصيلية

sampleLocation(latitude, longitude)

لعرض بيانات الارتفاع لنقطة واحدة (خط الطول/خط العرض).

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

لعرض بيانات الارتفاع لسلسلة من النقاط (خط الطول/خط العرض).

// 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 يحتوي على بيانات الارتفاع، كما هو موضّح هنا