Class ElevationSampler

Campionatore di elevazione

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

Documentazione dettagliata

sampleLocation(latitude, longitude)

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

Indietro

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

---

sampleLocations(points)

Restituisce i dati di elevazione per una serie di punti (latitudine/longitudine).

// 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 latitudine/longitudine.

Indietro

Object: un oggetto JSON contenente i dati di elevazione, 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.
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.

Indietro

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

---

samplePath(points, numSamples)

Restituisce i dati di elevazione per un numero di campioni lungo una linea, definita 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 latitudine/longitudine che definiscono un percorso su cui campionare.
numSamples	Integer	Il numero di punti da campionare lungo il percorso dei punti.

Indietro

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

---

samplePath(encodedPolyline, numSamples)

Restituisce i dati di elevazione per un numero di campioni lungo una linea, definita 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	Una polilinea codificata di punti che definiscono un percorso da campionare.
numSamples	Integer	Il numero di punti da campionare lungo il percorso dei punti.

Indietro

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