Class ElevationSampler

ElevationSampler

Ermöglicht die Stichprobenerhebung von Höhen an bestimmten Orten.
Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse den höchsten Punkt entlang der Route von Denver nach Grand Junction in Colorado ermitteln, auf einer Karte eintragen und die Karte in Google Drive speichern. 

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

Weitere Informationen

Methoden

MethodeRückgabetypKurzbeschreibung
sampleLocation(latitude, longitude)ObjectGibt Höhendaten für einen einzelnen Punkt (Breiten-/Längengrad) zurück.
sampleLocations(points)ObjectGibt Höhendaten für eine Reihe von Punkten (Breiten-/Längengrad) zurück.
sampleLocations(encodedPolyline)ObjectGibt Höhendaten für die Punkte in einer codierten Polylinie zurück.
samplePath(points, numSamples)ObjectGibt Höhendaten für eine Reihe von Beispielen entlang einer Linie zurück, die durch eine Reihe von Punkten definiert ist.
samplePath(encodedPolyline, numSamples)ObjectGibt Höhendaten für eine Reihe von Beispielen entlang einer Linie zurück, die mit einer codierten Polylinie definiert ist.

Detaillierte Dokumentation

sampleLocation(latitude, longitude)

Gibt Höhendaten für einen einzelnen Punkt (Breiten-/Längengrad) zurück. 

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

Parameter

NameTypBeschreibung
latitudeNumberBreitengrad des zu erfassenden Punkts
longitudeNumberden Längengrad des zu erfassenden Punkts

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, wie hier beschrieben

sampleLocations(points)

Gibt Höhendaten für eine Reihe von Punkten (Breiten-/Längengrad) zurück. 

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

Parameter

NameTypBeschreibung
pointsNumber[]ein Array von Breiten-/Längengrad-Paaren

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, wie hier beschrieben

sampleLocations(encodedPolyline)

Gibt Höhendaten für die Punkte in einer codierten Polylinie zurück. 

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

Parameter

NameTypBeschreibung
encodedPolylineStringeine codierte Polylinie mit Punkten, die zu erfassen sind

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, wie hier beschrieben

samplePath(points, numSamples)

Gibt Höhendaten für eine Reihe von Beispielen entlang einer Linie zurück, die durch eine Reihe von Punkten definiert ist. 

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

Parameter

NameTypBeschreibung
pointsNumber[]ein Array von Breiten-/Längengrad-Paaren, das einen Pfad definiert, über den Stichproben erhoben werden sollen
numSamplesIntegerdie Anzahl der Punkte, die entlang des Punktpfads zu erfassen sind

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, wie hier beschrieben

samplePath(encodedPolyline, numSamples)

Gibt Höhendaten für eine Reihe von Beispielen entlang einer Linie zurück, die mit einer codierten Polylinie definiert ist. 

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

Parameter

NameTypBeschreibung
encodedPolylineStringeine codierte Polylinie mit Punkten, die einen Pfad definieren, entlang dem Proben genommen werden sollen
numSamplesIntegerdie Anzahl der Punkte, die entlang des Punktpfads zu erfassen sind

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, wie hier beschrieben