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

المَعلمات

الاسمTypeالوصف
latitudeNumberخط العرض للنقطة للعينة
longitudeNumberخط طول النقطة للعينة

استرجاع الكرة

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);
}

المَعلمات

الاسمTypeالوصف
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);
}

المَعلمات

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

استرجاع الكرة

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