Questa pagina è stata tradotta dall'API Cloud Translation.

Class ElevationSampler

Consente di campionare le altitudini in località specifiche.
L'esempio seguente mostra come utilizzare questa classe per determinare il punto più alto del percorso da Denver a Grand Junction in Colorado, tracciarlo su una mappa e salvarlo su 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'));

Vedi anche

API Google Elevation

Metodi

Metodo	Tipo restituito	Breve descrizione
`sampleLocation(latitude, longitude)`	`Object`	Restituisce i dati sull'altitudine per un singolo punto (lat/lng).
`sampleLocations(points)`	`Object`	Restituisce dati sull'altitudine per una serie di punti (lat/lng).
`sampleLocations(encodedPolyline)`	`Object`	Restituisce i dati di altitudine per i punti in una polilinea codificata.
`samplePath(points, numSamples)`	`Object`	Restituisce i dati di altitudine per un numero di campioni lungo una linea, definiti utilizzando una serie di punti.
`samplePath(encodedPolyline, numSamples)`	`Object`	Restituisce i dati di altitudine per un numero di campioni lungo una linea, definiti utilizzando una polilinea codificata.

Documentazione dettagliata

`sampleLocation(latitude, longitude)`

Restituisce i dati sull'altitudine per un singolo punto (lat/lng).

// Gets the elevation of Times Square using a point.
var data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472);
Logger.log(data.results[0].elevation);

Parametri

Nome	Tipo	Descrizione
`latitude`	`Number`	la latitudine del punto da campionare
`longitude`	`Number`	la longitudine del punto da campionare

Ritorni

Object: un oggetto JSON contenente i dati di altitudine, come descritto qui

`sampleLocations(points)`

Restituisce dati sull'altitudine per una serie di punti (lat/lng).

// 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);

Parametri

Nome	Tipo	Descrizione
`points`	`Number[]`	un array di coppie latitudine/longitudine

Ritorni

Object: un oggetto JSON contenente i dati di altitudine, come descritto qui

`sampleLocations(encodedPolyline)`

Restituisce i dati di altitudine per i punti in una polilinea codificata.

// 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);

Parametri

Nome	Tipo	Descrizione
`encodedPolyline`	`String`	una polilinea codificata di punti da campionare

Ritorni

Object: un oggetto JSON contenente i dati di altitudine, come descritto qui

`samplePath(points, numSamples)`

Restituisce i dati di altitudine per un numero di campioni lungo una linea, definiti utilizzando una serie di punti.

// 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);
}

Parametri

Nome	Tipo	Descrizione
`points`	`Number[]`	un array di coppie latitudine/longitudine che definiscono un percorso per il campionamento
`numSamples`	`Integer`	Il numero di punti da campionare lungo il percorso dei punti

Ritorni

Object: un oggetto JSON contenente i dati di altitudine, come descritto qui

`samplePath(encodedPolyline, numSamples)`

Restituisce i dati di altitudine per un numero di campioni lungo una linea, definiti utilizzando una polilinea codificata.

// 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);
}

Parametri

Nome	Tipo	Descrizione
`encodedPolyline`	`String`	una polilinea codificata di punti che definisce un percorso di campionamento
`numSamples`	`Integer`	Il numero di punti da campionare lungo il percorso dei punti

Ritorni

Object: un oggetto JSON contenente i dati di altitudine, come descritto qui