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

• Google Elevation API

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
sampleLocation(latitude, longitude)	Object	Gibt Höhendaten für einen einzelnen Punkt (Breiten-/Längengrad) zurück.
sampleLocations(points)	Object	Gibt Höhendaten für eine Reihe von Punkten (Breiten-/Längengrad) 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 Beispielen entlang einer Linie zurück, die durch eine Reihe von Punkten definiert ist.
samplePath(encodedPolyline, numSamples)	Object	Gibt 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

Name	Typ	Beschreibung
latitude	Number	Breitengrad des zu erfassenden Punkts
longitude	Number	den 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

Name	Typ	Beschreibung
points	Number[]	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

Name	Typ	Beschreibung
encodedPolyline	String	eine 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

Name	Typ	Beschreibung
points	Number[]	ein Array von Breiten-/Längengrad-Paaren, das einen Pfad definiert, über den Stichproben erhoben werden sollen
numSamples	Integer	die 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

Name	Typ	Beschreibung
encodedPolyline	String	eine codierte Polylinie mit Punkten, die einen Pfad definieren, entlang dem Proben genommen werden sollen
numSamples	Integer	die Anzahl der Punkte, die entlang des Punktpfads zu erfassen sind

Rückflug

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