Class ElevationSampler

ElevationSampler

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étodoTipo de datos que se muestraDescripción breve
sampleLocation(latitude, longitude)ObjectMuestra datos de elevación para un único punto (lat/long).
sampleLocations(points)ObjectMuestra datos de elevación para una serie de puntos (lat/long).
sampleLocations(encodedPolyline)ObjectMuestra datos de elevación de los puntos de una polilínea codificada.
samplePath(points, numSamples)ObjectDevuelve 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)ObjectDevuelve 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

NombreTipoDescripción
latitudeNumberla latitud del punto para muestrear
longitudeNumberla 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

NombreTipoDescripción
pointsNumber[]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

NombreTipoDescripción
encodedPolylineStringuna 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

NombreTipoDescripción
pointsNumber[]un array de pares de latitud y longitud que define un trayecto para obtener un muestreo
numSamplesIntegerla 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

NombreTipoDescripción
encodedPolylineStringuna polilínea codificada de puntos que define un trazado para muestrear
numSamplesIntegerla 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í.