Class ElevationSampler

ElevationSampler

Permite el muestreo de elevaciones en ubicaciones particulares.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para determinar el punto más alto de la ruta de Denver a Grand Junction en Colorado, traza un mapa y guárdalo 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

• API de Google Elevation

Métodos

Método	Tipo de datos que se muestra	Descripción breve
sampleLocation(latitude, longitude)	Object	Muestra datos de elevación para un solo punto (lat/long).
sampleLocations(points)	Object	Muestra datos de elevación para una serie de puntos (lat/long).
sampleLocations(encodedPolyline)	Object	Devuelve datos de elevación para los puntos en 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 una serie de 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 solo 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

Volver

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 coordenadas de latitud y longitud

Volver

Object: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.

---

sampleLocations(encodedPolyline)

Devuelve datos de elevación para los puntos en 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 tomar muestras

Volver

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 definen una ruta para tomar muestras
numSamples	Integer	la cantidad de puntos para muestrear a lo largo de la ruta de puntos

Volver

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 una serie de 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 definen una ruta para tomar muestras
numSamples	Integer	la cantidad de puntos para muestrear a lo largo de la ruta de puntos

Volver

Object: Es un objeto JSON que contiene los datos de elevación, como se describe aquí.