允許對特定位置的海拔高度進行取樣。
以下範例說明如何使用此類別判斷路線上的最高點
例如美國科羅拉多州的丹佛到大章克 (Grand Junction) 繪製地圖,並將地圖儲存至 Google 雲端硬碟。
// 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 物件,如這裡所述