Elevation

Class ElevationService

google.maps.ElevationService class
library "elevation"

Menentukan class layanan yang berkomunikasi langsung dengan server Google untuk meminta data elevasi.

const {ElevationService} = await google.maps.importLibrary("elevation");

Konstruktor
ElevationService	ElevationService() Parameter: Tidak ada Membuat instance baru ElevationService yang mengirimkan kueri elevasi ke server Google.

Metode
getElevationAlongPath	getElevationAlongPath(request[, callback]) Parameter: request: PathElevationRequest callback: function(Array<ElevationResult> optional, ElevationStatus): void optional Nilai Hasil: Promise<PathElevationResponse> Membuat permintaan elevasi di sepanjang jalur, dengan data elevasi ditampilkan sebagai sampel berbasis jarak di sepanjang jalur tersebut.
getElevationForLocations	getElevationForLocations(request[, callback]) Parameter: request: LocationElevationRequest callback: function(Array<ElevationResult> optional, ElevationStatus): void optional Nilai Hasil: Promise<LocationElevationResponse> Membuat permintaan elevasi untuk daftar lokasi terpisah.

Antarmuka LocationElevationRequest

Antarmuka google.maps.LocationElevationRequest

Permintaan elevasi yang dikirim oleh ElevationService yang berisi daftar koordinat diskret (LatLng) yang akan menampilkan data elevasi.

Properti
locations opsional	Jenis: Array<LatLng|LatLngLiteral> optional Lokasi terpisah yang akan diambil elevasinya.

Antarmuka LocationElevationResponse

Antarmuka google.maps.LocationElevationResponse

Respons elevasi yang ditampilkan oleh ElevationService yang berisi daftar ElevationResult yang cocok dengan lokasi LocationElevationRequest.

Properti
results	Jenis: Array<ElevationResult> Daftar ElevationResult yang cocok dengan lokasi LocationElevationRequest.

Antarmuka PathElevationRequest

Antarmuka google.maps.PathElevationRequest

Kueri elevasi yang dikirim oleh ElevationService yang berisi jalur yang data sampelnya akan ditampilkan. Permintaan ini menentukan jalur berkelanjutan di sepanjang bumi yang sampel elevasinya harus diambil pada jarak yang sama. Semua jalur dari verteks ke verteks menggunakan segmen lingkaran besar di antara kedua titik tersebut.

Properti
samples	Jenis: number Wajib. Jumlah titik berjarak sama di sepanjang jalur yang diberikan untuk mengambil data elevasi, termasuk endpoint. Jumlah sampel harus berupa nilai antara 2 dan 512 inklusif.
path opsional	Jenis: Array<LatLng|LatLngLiteral> optional Jalur yang digunakan untuk mengumpulkan nilai elevasi.

Antarmuka PathElevationResponse

Antarmuka google.maps.PathElevationResponse

Respons elevasi yang ditampilkan oleh ElevationService yang berisi daftar ElevationResult yang berjarak sama di sepanjang jalur PathElevationRequest.

Properti
results	Jenis: Array<ElevationResult> Daftar ElevationResult yang cocok dengan sampel PathElevationRequest.

Antarmuka ElevationResult

Antarmuka google.maps.ElevationResult

Hasil permintaan ElevationService, yang terdiri dari kumpulan koordinat elevasi dan nilai elevasinya. Perhatikan bahwa satu permintaan dapat menghasilkan beberapa ElevationResult.

Properti
elevation	Jenis: number Elevasi titik ini di Bumi, dalam meter di atas permukaan laut.
resolution	Jenis: number Jarak, dalam meter, antara titik sampel yang digunakan untuk interpolasi elevasi. Properti ini tidak akan ada jika resolusi tidak diketahui. Perhatikan bahwa data elevasi akan menjadi kurang akurat (nilai resolution lebih besar) jika beberapa titik diteruskan. Untuk memperoleh nilai elevasi yang paling akurat bagi sebuah titik, maka harus dibuat kueri terpisah.
location opsional	Jenis: LatLng optional Lokasi hasil elevasi ini.

Konstanta ElevationStatus

google.maps.ElevationStatus konstanta library
"elevation"

Status yang ditampilkan oleh ElevationService setelah permintaan elevasi selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.ElevationStatus.OK.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");

Konstanta
INVALID_REQUEST	Permintaan tidak valid.
OK	Permintaan tidak mengalami error.
OVER_QUERY_LIMIT	Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat.
REQUEST_DENIED	Halaman web tidak diizinkan untuk menggunakan layanan elevasi.
UNKNOWN_ERROR	Permintaan elevasi tidak dapat diproses, tetapi alasan pasti kegagalannya tidak diketahui.