Class ElevationSampler

ElevationSampler

Ermöglicht das Erfassen von Höhendaten für bestimmte Standorte.
Das folgende Beispiel zeigt, wie Sie mit dieser Klasse den höchsten Punkt auf der Route bestimmen können. von Denver nach Grand Junction in Colorado, zeichnen Sie ihn auf einer Karte ab und speichern Sie sie in 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'));

Weitere Informationen

Methoden

MethodeRückgabetypKurzbeschreibung
sampleLocation(latitude, longitude)ObjectGibt Höhendaten für einen einzelnen Punkt zurück (lat/lng).
sampleLocations(points)ObjectGibt Höhendaten für eine Reihe von Punkten (lat/lng) 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 mithilfe einer Reihe von Punkten definiert werden.
samplePath(encodedPolyline, numSamples)ObjectGibt Höhendaten für eine Reihe von Stichproben entlang einer Linie zurück, die mithilfe einer codierten Polylinie definiert werden.

Detaillierte Dokumentation

sampleLocation(latitude, longitude)

Gibt Höhendaten für einen einzelnen Punkt zurück (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);

Parameter

NameTypBeschreibung
latitudeNumberBreitengrad des abzutastenden Punkts
longitudeNumberder Längengrad des zu erfassenden Punkts

Rückflug

Object: Ein JSON-Objekt, das die Höhendaten enthält, wie hier beschrieben.


sampleLocations(points)

Gibt Höhendaten für eine Reihe von Punkten (lat/lng) zurück.

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

Parameter

NameTypBeschreibung
pointsNumber[]Ein Array von Längen- und Breitengradpaaren

Rückflug

Object: Ein JSON-Objekt, das die Höhendaten enthält, 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.
var 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 von Punkten, die abgetastet werden sollen

Rückflug

Object: Ein JSON-Objekt, das die Höhendaten enthält, wie hier beschrieben.


samplePath(points, numSamples)

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

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

Parameter

NameTypBeschreibung
pointsNumber[]Ein Array von Breitengrad/Längengrad-Paaren, die einen Pfad für die Stichprobenerhebung definieren
numSamplesIntegerdie Anzahl der Punkte, die entlang des Pfads der Punkte erfasst werden sollen

Rückflug

Object: Ein JSON-Objekt, das die Höhendaten enthält, wie hier beschrieben.


samplePath(encodedPolyline, numSamples)

Gibt Höhendaten für eine Reihe von Stichproben entlang einer Linie zurück, die mithilfe einer codierten Polylinie definiert werden.

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

Parameter

NameTypBeschreibung
encodedPolylineStringEine codierte Polylinie von Punkten, die einen Pfad für die Stichprobe definiert
numSamplesIntegerdie Anzahl der Punkte, die entlang des Pfads der Punkte erfasst werden sollen

Rückflug

Object: Ein JSON-Objekt, das die Höhendaten enthält, wie hier beschrieben.