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ż

Metody

MetodaZwracany typKrótki opis
sampleLocation(latitude, longitude)ObjectZwraca dane dotyczące wysokości pojedynczego punktu (szer/dł).
sampleLocations(points)ObjectZwraca dane dotyczące wysokości dla serii punktów (lat/lng).
sampleLocations(encodedPolyline)ObjectZwraca dane dotyczące wysokości punktów w zakodowanej ścieżce wielokąta.
samplePath(points, numSamples)ObjectZwraca dane dotyczące wysokości dla wielu próbek wzdłuż linii zdefiniowanej za pomocą ciągu punktów.
samplePath(encodedPolyline, numSamples)ObjectZwraca dane wysokościowe 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

NazwaTypOpis
latitudeNumberszerokość geograficzna punktu, z którego mają być pobierane próbki.
longitudeNumberdł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

NazwaTypOpis
pointsNumber[]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 zakodowanej ścieżce wielokąta. 

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

NazwaTypOpis
encodedPolylineStringzakodowana 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

NazwaTypOpis
pointsNumber[]tablica par szerokości i długości geograficznej określająca ścieżkę do próbkowania
numSamplesIntegerliczba 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 wysokościowe 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

NazwaTypOpis
encodedPolylineStringzakodowany wielokąt z punktami określający ścieżkę do próbkowania
numSamplesIntegerliczba punktów do próbkowania wzdłuż ścieżki punktów;

Powrót

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