Class ElevationSampler

ElevationSampler

Consente di campionare le elevazioni in località specifiche.
L'esempio riportato di seguito 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 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

Metodi

MetodoTipo restituitoBreve descrizione
sampleLocation(latitude, longitude)ObjectRestituisce i dati di elevazione per un singolo punto (lat/lng).
sampleLocations(points)ObjectRestituisce i dati di elevazione per una serie di punti (lat/lng).
sampleLocations(encodedPolyline)ObjectRestituisce i dati di elevazione per i punti in una polilinea codificata.
samplePath(points, numSamples)ObjectRestituisce i dati di elevazione per un numero di campioni lungo una linea, definita utilizzando una serie di punti.
samplePath(encodedPolyline, numSamples)ObjectRestituisce 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

NomeTipoDescrizione
latitudeNumberLa latitudine del punto da campionare.
longitudeNumberLa 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 (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

NomeTipoDescrizione
pointsNumber[]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

NomeTipoDescrizione
encodedPolylineStringUna 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

NomeTipoDescrizione
pointsNumber[]Un array di coppie latitudine/longitudine che definiscono un percorso da campionare.
numSamplesIntegerIl 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

NomeTipoDescrizione
encodedPolylineStringUna polilinea codificata di punti che definiscono un percorso da campionare.
numSamplesIntegerIl numero di punti da campionare lungo il percorso dei punti.

Indietro

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