تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

انظر أيضًا

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