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

راجع أيضًا

الطُرق

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

المستندات التفصيلية

sampleLocation(latitude, longitude)

عرض بيانات الارتفاع لنقطة واحدة (لاتيه/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);

المعلّمات

الاسمالنوعالوصف
latitudeNumberخط عرض النقطة التي تريد أخذ عيّنة منها
longitudeNumberخط الطول لنقطة النقطة

تذكرة ذهاب وعودة

Object: كائن JSON يحتوي على بيانات الارتفاع، كما هو مُوضَّح هنا


sampleLocations(points)

عرض بيانات الارتفاع لسلسلة من النقاط (لاتيه/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);

المعلّمات

الاسمالنوعالوصف
pointsNumber[]مصفوفة من أزواج خطوط الطول/العرض

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
encodedPolylineStringخط متعدد مشفّر من النقاط للحصول على عينة

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
pointsNumber[]مصفوفة من أزواج خطوط الطول/العرض تحدّد مسارًا لإنشاء عيّنة منها
numSamplesIntegerعدد النقاط التي يجب أخذ عيّنة منها على مسار النقاط

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
encodedPolylineStringخط متعدد مشفّر للنقاط يحدد مسارًا لنموذج
numSamplesIntegerعدد النقاط التي يجب أخذ عيّنة منها على مسار النقاط

تذكرة ذهاب وعودة

Object: كائن JSON يحتوي على بيانات الارتفاع، كما هو مُوضَّح هنا