Diese Seite wurde von der Cloud Translation API übersetzt.

Class ElevationSampler

Ermöglicht die Erhebung von Höhendaten an bestimmten Standorten.
Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse den höchsten Punkt auf der Route von Denver nach Grand Junction in Colorado ermitteln, ihn auf einer Karte grafisch darstellen und die Karte in Google Drive speichern.

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

Google Elevation API

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`sampleLocation(latitude, longitude)`	`Object`	Gibt Höhendaten für einen einzelnen Punkt (lat/lng) zurück.
`sampleLocations(points)`	`Object`	Gibt Höhendaten für eine Reihe von Punkten (lat/lng) zurück.
`sampleLocations(encodedPolyline)`	`Object`	Gibt Höhendaten für die Punkte in einer codierten Polylinie zurück.
`samplePath(points, numSamples)`	`Object`	Gibt Höhendaten für eine Reihe von Stichproben entlang einer Linie zurück, die durch eine Reihe von Punkten definiert werden.
`samplePath(encodedPolyline, numSamples)`	`Object`	Gibt Höhendaten für eine Reihe von Beispielen entlang einer Linie zurück, die mithilfe einer codierten Polylinie definiert wird.

Detaillierte Dokumentation

`sampleLocation(latitude, longitude)`

Gibt Höhendaten für einen einzelnen Punkt (lat/lng) zurück.

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

Name	Typ	Beschreibung
`latitude`	`Number`	Breitengrad des Punkts, der erfasst werden soll
`longitude`	`Number`	Längengrad des Punkts, der erfasst werden soll

Return

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

Name	Typ	Beschreibung
`points`	`Number[]`	Array mit Längen- und Breitengradpaaren

Return

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

Name	Typ	Beschreibung
`encodedPolyline`	`String`	eine codierte Polylinie mit Punkten für die Stichprobe

Return

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

`samplePath(points, numSamples)`

Gibt Höhendaten für eine Reihe von Stichproben entlang einer Linie zurück, die durch eine 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

Name	Typ	Beschreibung
`points`	`Number[]`	Array mit Längen- und Breitengradpaaren, die einen Pfad für die Stichprobenerhebung definieren
`numSamples`	`Integer`	Anzahl der Punkte, die entlang des Pfads der Punkte erfasst werden sollen

Return

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

`samplePath(encodedPolyline, numSamples)`

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

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

Name	Typ	Beschreibung
`encodedPolyline`	`String`	Eine codierte Polylinie von Punkten, die einen Pfad für die Stichprobe definiert
`numSamples`	`Integer`	Anzahl der Punkte, die entlang des Pfads der Punkte erfasst werden sollen

Return

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