Coordinates

LatLng class

Class google.maps.LatLng

LatLng adalah titik dalam koordinat geografis: lintang dan bujur.

  • Rentang lintang antara -90 dan 90 derajat, inklusif. Nilai di atas atau di bawah rentang ini akan dibulatkan ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilai tersebut akan disetel ke -90. Jika nilainya lebih besar dari 90, nilainya akan ditetapkan ke 90.
  • Rentang bujur antara -180 dan 180 derajat, inklusif. Nilai di atas atau di bawah rentang ini akan dibulatkan agar berada dalam rentang. Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 190 akan dikonversi menjadi -170. Hal ini mencerminkan fakta bahwa garis bujur mengelilingi dunia.
Meskipun proyeksi peta default mengaitkan bujur dengan koordinat x peta, dan lintang dengan koordinat y, koordinat lintang selalu ditulis terlebih dahulu, diikuti dengan bujur.
Perhatikan bahwa Anda tidak dapat mengubah koordinat LatLng. Jika Anda ingin menghitung titik lain, Anda harus membuat titik baru.

Sebagian besar metode yang menerima objek LatLng juga menerima objek LatLngLiteral, sehingga berikut ini setara: 

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151});

Konstruktor juga menerima objek LatLngLiteral dan LatLng. Jika instance LatLng diteruskan ke konstruktor, salinan akan dibuat.

Panggilan yang mungkin ke konstruktor adalah sebagai berikut: 

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

Akses dengan memanggil const {LatLng} = await google.maps.importLibrary("core").
Lihat Library di Maps JavaScript API.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parameter: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
Membuat objek LatLng yang merepresentasikan titik geografis. Lintang ditentukan dalam derajat dalam rentang [-90, 90]. Bujur ditentukan dalam derajat dalam rentang [-180, 180). Tetapkan noClampNoWrap ke true untuk mengaktifkan nilai di luar rentang ini. Perhatikan urutan lintang dan bujur.
equals
equals(other)
Parameter: 
Nilai yang Ditampilkan:  boolean
Fungsi perbandingan.
lat
lat()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  number
Menampilkan garis lintang dalam derajat.
lng
lng()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  number
Menampilkan bujur dalam derajat.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLngLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.
toString
toString()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string
Mengonversi ke representasi string.
toUrlValue
toUrlValue([precision])
Parameter: 
  • precision:  number optional
Nilai yang Ditampilkan:  string
Menampilkan string dalam bentuk "lat,lng" untuk LatLng ini. Secara default, kami membulatkan nilai lat/lng menjadi 6 tempat desimal.

Antarmuka LatLngLiteral

google.maps.LatLngLiteral interface

Literal objek diterima sebagai pengganti objek LatLng, sebagai kemudahan, di banyak tempat. Objek ini dikonversi menjadi objek LatLng saat Maps API menemuinya.

Contoh: 

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Literal objek LatLng tidak didukung di library Geometry.
lat
Jenis:  number
Lintang dalam derajat. Nilai akan dikunci ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilai tersebut akan disetel ke -90. Jika nilainya lebih besar dari 90, nilainya akan ditetapkan ke 90.
lng
Jenis:  number
Bujur dalam derajat. Nilai di luar rentang [-180, 180] akan dibulatkan agar berada dalam rentang. Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 190 akan dikonversi menjadi -170. Hal ini mencerminkan fakta bahwa garis bujur mengelilingi dunia.

Class LatLngBounds

Class google.maps.LatLngBounds

Instance LatLngBounds merepresentasikan persegi panjang dalam koordinat geografis, termasuk yang melintasi meridian bujur 180 derajat.

Akses dengan memanggil const {LatLngBounds} = await google.maps.importLibrary("core").
Lihat Library di Maps JavaScript API.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parameter: 
Membangun persegi panjang dari titik-titik di sudut barat daya dan timur lautnya.
MAX_BOUNDS LatLngBounds untuk batas maksimum Bumi. Batas ini akan mencakup seluruh dunia.
contains
contains(latLng)
Parameter: 
Nilai yang Ditampilkan:  boolean
Menampilkan true jika lat/lng yang diberikan berada dalam batas ini.
equals
equals(other)
Parameter: