Позволяет производить выборку высот в определенных местах.
В приведенном ниже примере показано, как вы можете использовать этот класс, чтобы определить самую высокую точку на маршруте от Денвера до Гранд-Джанкшен в Колорадо, нанести ее на карту и сохранить карту на 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, содержащий данные о высоте, как описано здесь.