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

Class ElevationSampler

Permite el muestreo de elevaciones en ubicaciones específicas.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para determinar el punto más alto a lo largo de la ruta de Denver a Grand Junction en Colorado, trazarlo en un mapa y guardarlo en Google Drive.

// Get directions from Denver to Grand Junction.
const directions = Maps.newDirectionFinder()
                       .setOrigin('Denver, CO')
                       .setDestination('Grand Junction, CO')
                       .setMode(Maps.DirectionFinder.Mode.DRIVING)
                       .getDirections();
const route = directions.routes[0];

// Get elevation samples along the route.
const numberOfSamples = 30;
const response = Maps.newElevationSampler().samplePath(
    route.overview_polyline.points,
    numberOfSamples,
);

// Determine highest point.

let highestLocation = null;
let highestElevation = Number.MIN_VALUE;
for (const sample of response.results) {
  if (sample.elevation > highestElevation) {
    highestElevation = sample.elevation;
    highestLocation = sample.location;
  }
}

// Add the path and marker to a map.
const map = Maps.newStaticMap()
                .addPath(route.overview_polyline.points)
                .addMarker(highestLocation.lat, highestLocation.lng);

// Save the map to your drive
DriveApp.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`	Devuelve datos de elevación para un solo punto (lat/lng).
`sampleLocations(points)`	`Object`	Devuelve datos de elevación para una serie de puntos (lat/lng).
`sampleLocations(encodedPolyline)`	`Object`	Muestra datos de elevación para los puntos de un polilínea codificado.
`samplePath(points, numSamples)`	`Object`	Muestra datos de elevación para una serie de muestras a lo largo de una línea, definida con una serie de puntos.
`samplePath(encodedPolyline, numSamples)`	`Object`	Devuelve datos de elevación para una cantidad de muestras a lo largo de una línea, definida con un polilínea codificado.

Documentación detallada

`sampleLocation(latitude, longitude)`

Devuelve datos de elevación para un solo punto (lat/lng).

// Gets the elevation of Times Square using a point.
const 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 que se va a muestrear
`longitude`	`Number`	la longitud del punto que se va a muestrear

Volver

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

`sampleLocations(points)`

Devuelve datos de elevación para una serie de puntos (lat/lng).

// Gets the elevation of Times Square and Central Park using points.
const 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

Volver

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

`sampleLocations(encodedPolyline)`

Muestra datos de elevación para los puntos de un polilínea codificado.

// Gets the elevation of Times Square and Central Park using a polyline.
const 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

Volver

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

`samplePath(points, numSamples)`

Muestra datos de elevación para una serie de muestras a lo largo de una línea, definida con una serie de puntos.

// Gets the elevation of five points between Times Square and Central Park.
const data = Maps.newElevationSampler().samplePath(
    [
      // Times Square
      40.759011,
      -73.984472,
      // Central Park
      40.777052,
      -73.975464,
    ],
    5,
);
for (let 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 muestrear
`numSamples`	`Integer`	la cantidad de puntos que se deben 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 cantidad de muestras a lo largo de una línea, definida con un polilínea codificado.

// Gets the elevation of five points between Times Square and Central Park.
const data = Maps.newElevationSampler().samplePath('yvwwF|aqbMwoBiw@', 5);
for (let 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 una ruta para muestrear
`numSamples`	`Integer`	la cantidad de puntos que se deben 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í.