Class ElevationSampler

Sampler Wzniesienie

Umożliwia próbkowanie wysokości w określonych lokalizacjach.
Przykład poniżej pokazuje, jak za pomocą tej klasy można określić najwyższy punkt na trasie z Denver do Grand Junction w Kolorado, narysować go na mapie i zapisać mapę na Dysku Google.

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

Zobacz też

• Interfejs Google Elevation API

Metody

Metoda	Zwracany typ	Krótki opis
sampleLocation(latitude, longitude)	Object	Zwraca dane dotyczące wysokości pojedynczego punktu (szer/dł).
sampleLocations(points)	Object	Zwraca dane dotyczące wysokości dla serii punktów (lat/lng).
sampleLocations(encodedPolyline)	Object	Zwraca dane dotyczące wysokości punktów w zakodowanym wielokącie.
samplePath(points, numSamples)	Object	Zwraca dane wysokościowe dla wielu próbek wzdłuż linii zdefiniowanej za pomocą ciągu punktów.
samplePath(encodedPolyline, numSamples)	Object	Zwraca dane dotyczące wysokości dla kilku próbek wzdłuż linii zdefiniowanej za pomocą zakodowanej linii złożonej.

Szczegółowa dokumentacja

sampleLocation(latitude, longitude)

Zwraca dane dotyczące wysokości pojedynczego punktu (szer/dł).

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

Parametry

Nazwa	Typ	Opis
latitude	Number	szerokość geograficzna punktu, z którego mają być pobierane próbki.
longitude	Number	długość geograficzna punktu, z którego mają być pobierane dane.

Powrót

Object – obiekt JSON zawierający dane wysokościowe opisane tutaj

---

sampleLocations(points)

Zwraca dane dotyczące wysokości dla serii punktów (lat/lng).

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

Parametry

Nazwa	Typ	Opis
points	Number[]	tablica par szerokości i długości geograficznej

Powrót

Object – obiekt JSON zawierający dane wysokościowe opisane tutaj

---

sampleLocations(encodedPolyline)

Zwraca dane dotyczące wysokości punktów w zakodowanym wielokącie.

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

Parametry

Nazwa	Typ	Opis
encodedPolyline	String	zakodowana linia złożona z punktów do próbkowania;

Powrót

Object – obiekt JSON zawierający dane wysokościowe opisane tutaj

---

samplePath(points, numSamples)

Zwraca dane wysokościowe dla wielu próbek wzdłuż linii zdefiniowanej za pomocą ciągu punktów.

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

Parametry

Nazwa	Typ	Opis
points	Number[]	tablica par szerokości i długości geograficznej określająca ścieżkę do próbkowania
numSamples	Integer	liczba punktów do próbkowania wzdłuż ścieżki punktów;

Powrót

Object – obiekt JSON zawierający dane wysokościowe opisane tutaj

---

samplePath(encodedPolyline, numSamples)

Zwraca dane dotyczące wysokości dla kilku próbek wzdłuż linii zdefiniowanej za pomocą zakodowanej linii złożonej.

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

Parametry

Nazwa	Typ	Opis
encodedPolyline	String	zakodowany wielokąt z punktami określający ścieżkę do próbkowania
numSamples	Integer	liczba punktów do próbkowania wzdłuż ścieżki punktów;

Powrót

Object – obiekt JSON zawierający dane wysokościowe opisane tutaj