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

المعلمات

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

المعلمات

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