Class ElevationSampler

ElevationSampler

Belirli konumlardaki yüksekliklerin örneklenmesine olanak tanır.
Aşağıdaki örnekte, bu sınıfı kullanarak Kolorado'daki Denver'dan Grand Junction'a giden rotadaki en yüksek noktayı nasıl belirleyebileceğiniz, haritayı harita üzerinde nasıl çizebileceğiniz ve haritayı Google Drive'a nasıl kaydedebileceğiniz gösterilmektedir.

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

Aşağıdaki kaynakları da incelemenizi öneririz:

Yöntemler

YöntemDönüş türüKısa açıklama
sampleLocation(latitude, longitude)ObjectTek bir noktanın yükseklik verilerini döndürür (enlem/boylam).
sampleLocations(points)ObjectBir dizi noktanın yükseklik verilerini döndürür (enlem/boylam).
sampleLocations(encodedPolyline)ObjectKodlanmış bir çoklu çizgideki noktaların yükseklik verilerini döndürür.
samplePath(points, numSamples)ObjectBir dizi nokta kullanılarak tanımlanan, bir çizgi boyunca çeşitli örneklere ait yükseklik verilerini döndürür.
samplePath(encodedPolyline, numSamples)ObjectKodlanmış bir çoklu çizgi kullanılarak tanımlanan, bir çizgi boyunca çeşitli örneklerin yükseklik verilerini döndürür.

Ayrıntılı belgeler

sampleLocation(latitude, longitude)

Tek bir noktanın yükseklik verilerini döndürür (enlem/boylam).

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

Parametreler

AdTürAçıklama
latitudeNumberörneklenecek noktanın enlemi
longitudeNumberörneklenecek noktanın boylamı

Return

Object: Burada açıklandığı gibi yükseklik verilerini içeren bir JSON Nesnesi


sampleLocations(points)

Bir dizi noktanın yükseklik verilerini döndürür (enlem/boylam).

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

Parametreler

AdTürAçıklama
pointsNumber[]enlem/boylam çiftleri dizisi

Return

Object: Burada açıklandığı gibi yükseklik verilerini içeren bir JSON Nesnesi


sampleLocations(encodedPolyline)

Kodlanmış bir çoklu çizgideki noktaların yükseklik verilerini döndürür.

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

Parametreler

AdTürAçıklama
encodedPolylineStringörneklenecek noktaların kodlanmış çoklu çizgisi

Return

Object: Burada açıklandığı gibi yükseklik verilerini içeren bir JSON Nesnesi


samplePath(points, numSamples)

Bir dizi nokta kullanılarak tanımlanan, bir çizgi boyunca çeşitli örneklere ait yükseklik verilerini döndürür.

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

Parametreler

AdTürAçıklama
pointsNumber[]üzerinden örneklenecek bir yolu tanımlayan enlem/boylam çiftleri dizisi
numSamplesIntegernoktaların yolu boyunca örneklenecek nokta sayısı

Return

Object: Burada açıklandığı gibi yükseklik verilerini içeren bir JSON Nesnesi


samplePath(encodedPolyline, numSamples)

Kodlanmış bir çoklu çizgi kullanılarak tanımlanan, bir çizgi boyunca çeşitli örneklerin yükseklik verilerini döndürür.

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

Parametreler

AdTürAçıklama
encodedPolylineStringörnekleme yolu tanımlayan noktaların kodlanmış çoklu çizgisi
numSamplesIntegernoktaların yolu boyunca örneklenecek nokta sayısı

Return

Object: Burada açıklandığı gibi yükseklik verilerini içeren bir JSON Nesnesi