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

انظر أيضًا

• Google Elevation API

الطُرق

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
points	Number[]	صفيف من أزواج خطوط الطول/خطوط العرض

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
encodedPolyline	String	خط متعدد مُشفَّر للنقاط التي سيتم أخذ عيّنات منها

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
points	Number[]	مصفوفة من أزواج خطوط العرض/خطوط الطول التي تحدّد مسارًا لأخذ العيّنات
numSamples	Integer	عدد النقاط التي سيتم أخذ عيّنات منها على طول مسار النقاط

الإرجاع

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

المعلَمات

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

الإرجاع

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