מאפשר דגימת גובה במיקומים מסוימים.
בדוגמה הבאה אפשר לראות איך אפשר להשתמש במחלקה הזו כדי לקבוע את הנקודה הגבוהה ביותר במסלול מדנוור אל גרנד ג'נקשן בקולורדו, לשרטט אותה במפה ולשמור את המפה ב-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);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
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 שמכיל את נתוני הגובה, כפי שמתואר כאן