Permite mostrar muestras de elevaciones en ubicaciones determinadas.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para determinar el punto más alto de la ruta desde Denver hasta Grand Junction en Colorado, trazarlo en un mapa y guardarlo en 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'));
Consulta también
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
sampleLocation(latitude, longitude) | Object | Muestra datos de elevación para un único punto (lat/long). |
sampleLocations(points) | Object | Muestra datos de elevación para una serie de puntos (lat/long). |
sampleLocations(encodedPolyline) | Object | Muestra datos de elevación de los puntos de una polilínea codificada. |
samplePath(points, numSamples) | Object | Devuelve datos de elevación para un número de muestras a lo largo de una línea, definidos mediante una serie de puntos. |
samplePath(encodedPolyline, numSamples) | Object | Devuelve datos de elevación para varios ejemplos a lo largo de una línea, definidos mediante una polilínea codificada. |
Documentación detallada
sampleLocation(latitude, longitude)
Muestra datos de elevación para un único punto (lat/long).
// Gets the elevation of Times Square using a point. var data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472); Logger.log(data.results[0].elevation);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | la latitud del punto para muestrear |
longitude | Number | la longitud del punto para muestrear |
Devolvedor
Object
: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.
sampleLocations(points)
Muestra datos de elevación para una serie de puntos (lat/long).
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
points | Number[] | un array de pares de latitud y longitud |
Devolvedor
Object
: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.
sampleLocations(encodedPolyline)
Muestra datos de elevación de los puntos de una polilínea codificada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
encodedPolyline | String | una polilínea codificada de puntos para muestrear |
Devolvedor
Object
: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.
samplePath(points, numSamples)
Devuelve datos de elevación para un número de muestras a lo largo de una línea, definidos mediante una serie de puntos.
// 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); }
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
points | Number[] | un array de pares de latitud y longitud que define un trayecto para obtener un muestreo |
numSamples | Integer | la cantidad de puntos de muestreo a lo largo de la ruta de puntos |
Devolvedor
Object
: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.
samplePath(encodedPolyline, numSamples)
Devuelve datos de elevación para varios ejemplos a lo largo de una línea, definidos mediante una polilínea codificada.
// 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); }
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
encodedPolyline | String | una polilínea codificada de puntos que define un trazado para muestrear |
numSamples | Integer | la cantidad de puntos de muestreo a lo largo de la ruta de puntos |
Devolvedor
Object
: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.