Class ElevationSampler

ElevationSampler

Ermöglicht die Stichprobenerhebung von Erhebungen an bestimmten Orten.
Im folgenden Beispiel sehen Sie, wie Sie diese Klasse verwenden können, um den höchsten Punkt auf der Route von Denver nach Grand Junction in Colorado zu ermitteln, ihn auf einer Karte darzustellen und die Karte in Google Drive zu 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 (Breitengrad/Längengrad) zurück.
sampleLocations(points)	Object	Gibt Höhendaten für eine Reihe von Punkten (Breitengrad/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 Stichproben entlang einer Linie zurück, die durch eine Reihe von Punkten definiert wird.
samplePath(encodedPolyline, numSamples)	Object	Gibt Höhendaten für eine Reihe von Stichproben entlang einer Linie zurück, die mit einer codierten Polylinie definiert wird.

Detaillierte Dokumentation

sampleLocation(latitude, longitude)

Gibt Höhendaten für einen einzelnen Punkt (Breitengrad/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	Der Breitengrad des zu untersuchenden Punkts.
longitude	Number	Der Längengrad des zu untersuchenden 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 (Breitengrad/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 Paaren aus Breiten- und Längengrad.

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 als Stichprobe dienen sollen.

Rückflug

Object: Ein JSON-Objekt mit den Höhendaten, 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 wird.

// 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 genommen werden sollen.
numSamples	Integer	Die Anzahl der Punkte, die entlang des Pfads der Punkte gezogen werden sollen.

Rückflug

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

---

samplePath(encodedPolyline, numSamples)

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

// 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, über den Stichproben genommen werden sollen.
numSamples	Integer	Die Anzahl der Punkte, die entlang des Pfads der Punkte gezogen werden sollen.

Rückflug

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