يسمح بأخذ عينات من الارتفاعات في مواقع معينة.
يوضح المثال أدناه كيف يمكنك استخدام هذه الفئة لتحديد أعلى نقطة على طول المسار
من دنفر إلى غراند جانكشن في كولورادو، ورسمها على الخريطة، وحفظ الخريطة في 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 | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
encodedPolyline | String | خط متعدد مرمّز من النقاط يحدد مسارًا لأخذ عينات عبر |
numSamples | Integer | عدد النقاط المطلوب أخذ عينات منها على طول مسار النقاط |
استرجاع الكرة
Object
— كائن JSON يحتوي على بيانات الارتفاع، كما هو موضّح هنا