Se usó la API de Cloud Translation para traducir esta página.

Class 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í.