Class ElevationSampler

YükseklikÖrnekleyici

Belirli konumlarda yüksekliklerin örneklenmesine olanak tanır.
Aşağıdaki örnekte, Denver'dan Colorado'daki Grand Junction'a giden rotadaki en yüksek noktayı belirlemek, bu noktayı bir haritada göstermek ve haritayı Google Drive'a kaydetmek için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir.

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

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

• Google Elevation API

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
sampleLocation(latitude, longitude)	Object	Tek bir noktanın (lat/lng) yükseklik verilerini döndürür.
sampleLocations(points)	Object	Bir dizi noktanın (lat/lng) yükseklik verilerini döndürür.
sampleLocations(encodedPolyline)	Object	Kodlanmış bir çok çizgideki noktaların yükseklik verilerini döndürür.
samplePath(points, numSamples)	Object	Bir dizi nokta kullanılarak tanımlanan bir çizgi üzerindeki çeşitli örneklerin yükseklik verilerini döndürür.
samplePath(encodedPolyline, numSamples)	Object	Kodlanmış bir çoklu çizgi kullanılarak tanımlanan bir çizgi üzerindeki çeşitli örneklerin yükseklik verilerini döndürür.

Ayrıntılı dokümanlar

sampleLocation(latitude, longitude)

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

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

Parametreler

Ad	Tür	Açıklama
latitude	Number	Örnek alınacak noktanın enlemi
longitude	Number	Örnek alınacak noktanın boylamı

Return

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

---

sampleLocations(points)

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

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

Parametreler

Ad	Tür	Açıklama
points	Number[]	enlem/boylam çiftleri dizisi

Return

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

---

sampleLocations(encodedPolyline)

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

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

Parametreler

Ad	Tür	Açıklama
encodedPolyline	String	Örnek alınacak noktaların kodlanmış bir ç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 üzerindeki çeşitli örneklerin yükseklik verilerini döndürür.

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

Parametreler

Ad	Tür	Açıklama
points	Number[]	Örnek alınacak bir yolu tanımlayan bir enlem/boylam çifti dizisi
numSamples	Integer	Noktaları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 üzerindeki çeşitli örneklerin yükseklik verilerini döndürür.

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

Parametreler

Ad	Tür	Açıklama
encodedPolyline	String	Örnek alınacak bir yolu tanımlayan, noktalardan oluşan kodlanmış bir poli çizgi
numSamples	Integer	Noktaların yolu boyunca örneklenecek nokta sayısı

Return

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