Class ElevationSampler

أداة أخذ عيّنات الارتفاع

السماح بتحليل عيّنات من الارتفاعات في مواقع جغرافية معيّنة
يوضّح المثال أدناه كيفية استخدام هذه الفئة لتحديد أعلى نقطة على طول المسار من دنفر إلى غراند اتّصال في كولورادو، ووضعها على خريطة، وحفظ الخريطة في Google Drive. 

// Get directions from Denver to Grand Junction.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Denver, CO')
                       .setDestination('Grand Junction, CO')
                       .setMode(Maps.DirectionFinder.Mode.DRIVING)
                       .getDirections();
const route = directions.routes[0];

// Get elevation samples along the route.
const numberOfSamples = 30;
const response = Maps.newElevationSampler().samplePath(
    route.overview_polyline.points,
    numberOfSamples,
);

// Determine highest point.

let highestLocation = null;
let highestElevation = Number.MIN_VALUE;
for (const sample of response.results) {
  if (sample.elevation > highestElevation) {
    highestElevation = sample.elevation;
    highestLocation = sample.location;
  }
}

// Add the path and marker to a map.
const map = Maps.newStaticMap()
                .addPath(route.overview_polyline.points)
                .addMarker(highestLocation.lat, highestLocation.lng);

// Save the map to your drive
DriveApp.createFile(
    Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'),
);

انظر أيضًا

الطُرق

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

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

sampleLocation(latitude, longitude)

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

// Gets the elevation of Times Square using a point.
const data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472);
Logger.log(data.results[0].elevation);

المعلمات

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

الإرجاع

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

sampleLocations(points)

لعرض بيانات الارتفاع لمجموعة من النقاط (lat/lng). 

// Gets the elevation of Times Square and Central Park using points.
const 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.
const 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.
const data = Maps.newElevationSampler().samplePath(
    [
      // Times Square
      40.759011,
      -73.984472,
      // Central Park
      40.777052,
      -73.975464,
    ],
    5,
);
for (let 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.
const data = Maps.newElevationSampler().samplePath('yvwwF|aqbMwoBiw@', 5);
for (let i = 0; i < data.results.length; i++) {
  Logger.log(data.results[i].elevation);
}

المعلمات

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

الإرجاع

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