Questa pagina è stata tradotta dall'API Cloud Translation.

Class ElevationSampler

Consente il campionamento delle elevazioni in determinate località.
L'esempio seguente mostra come utilizzare questa classe per determinare il punto più alto lungo il percorso da Denver a Grand Junction in Colorado, tracciali su una mappa e salvala 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 di elevazione di un singolo punto (lat/lng).
`sampleLocations(points)`	`Object`	Restituisce i dati di elevazione per una serie di punti (lat/lng).
`sampleLocations(encodedPolyline)`	`Object`	Restituisce i dati di elevazione per i punti in una polilinea codificata.
`samplePath(points, numSamples)`	`Object`	Restituisce i dati di elevazione per un certo numero di campioni lungo una linea, definita utilizzando una serie di punti.
`samplePath(encodedPolyline, numSamples)`	`Object`	Restituisce i dati di elevazione per un certo numero di campioni lungo una linea, definita utilizzando una polilinea codificata.

Documentazione dettagliata

`sampleLocation(latitude, longitude)`

Restituisce i dati di elevazione di 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

Invio

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

`sampleLocations(points)`

Restituisce i dati di elevazione 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[]`	una matrice di coppie latitudine/longitudine

Invio

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

`sampleLocations(encodedPolyline)`

Restituisce i dati di elevazione 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

Invio

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

`samplePath(points, numSamples)`

Restituisce i dati di elevazione per un certo numero di campioni lungo una linea, definita 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 definisce un percorso da campionare
`numSamples`	`Integer`	il numero di punti da campionare lungo il percorso dei punti

Invio

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

`samplePath(encodedPolyline, numSamples)`

Restituisce i dati di elevazione per un certo numero di campioni lungo una linea, definita 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 da campionare
`numSamples`	`Integer`	il numero di punti da campionare lungo il percorso dei punti

Invio

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