Class ElevationSampler

SamplerAltitudine

Consente il campionamento delle altezze 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, tracciarlo su una mappa e salvarla su 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'),
);

Vedi anche

• API Google Elevation

Metodi

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

Documentazione dettagliata

sampleLocation(latitude, longitude)

Restituisce i dati sull'elevazione per un singolo 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);

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 sull'elevazione, come descritto qui

---

sampleLocations(points)

Restituisce i dati sull'elevazione per una serie di punti (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}`);

Parametri

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

Invio

Object: un oggetto JSON contenente i dati sull'elevazione, come descritto qui

---

sampleLocations(encodedPolyline)

Restituisce i dati di elevazione per i punti di un polilinea codificato.

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

Parametri

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

Invio

Object: un oggetto JSON contenente i dati sull'elevazione, come descritto qui

---

samplePath(points, numSamples)

Restituisce i dati sull'elevazione per una serie di campioni lungo una linea, definiti utilizzando una serie di punti.

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

Parametri

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

Invio

Object: un oggetto JSON contenente i dati sull'elevazione, come descritto qui

---

samplePath(encodedPolyline, numSamples)

Restituisce i dati sull'elevazione per una serie di campioni lungo una linea, definiti utilizzando una polilinea codificata.

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

Parametri

Nome	Tipo	Descrizione
encodedPolyline	String	un polilinea codificato 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 sull'elevazione, come descritto qui