Coordinates

Class LatLng

Class google.maps.LatLng

LatLng adalah titik dalam koordinat geografis: lintang dan bujur.

  • Garis lintang berkisar 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, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
  • Rentang bujur antara -180 dan 180 derajat, inklusif. Nilai di atas atau di bawah rentang ini akan digabungkan 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 bola 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 memodifikasi koordinat LatLng. Jika ingin menghitung titik lain, Anda harus membuat titik baru.

Sebagian besar metode yang menerima objek LatLng juga menerima objek LatLngLiteral, sehingga kode berikut 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.

Kemungkinan panggilan 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({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

Akses dengan memanggil const {LatLng} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parameter: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Membuat objek LatLng yang mewakili 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 garis lintang dan bujur.
equals
equals(other)
Parameter: 
Nilai Hasil:  boolean
Fungsi perbandingan.
lat
lat()
Parameter: Tidak ada
Nilai Hasil:  number
Menampilkan garis lintang dalam derajat.
lng
lng()
Parameter: Tidak ada
Nilai Hasil:  number
Menampilkan bujur dalam derajat.
toJSON
toJSON()
Parameter: Tidak ada
Nilai Hasil:  LatLngLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.
toString
toString()
Parameter: Tidak ada
Nilai Hasil:  string
Mengonversi ke representasi string.
toUrlValue
toUrlValue([precision])
Parameter: 
  • precisionnumber optional
Nilai Hasil:  string
Menampilkan string dalam bentuk "lat,lng" untuk LatLng ini. Kami membulatkan nilai lintang/bujur menjadi 6 tempat desimal secara default.

Antarmuka LatLngLiteral

Antarmuka google.maps.LatLngLiteral

Literal objek diterima sebagai pengganti objek LatLng, sebagai kenyamanan, di banyak tempat. Ini dikonversi menjadi objek LatLng ketika Maps API menemukannya.

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 Geometri.

lat
Jenis:  number
Lintang dalam derajat. Nilai akan dikunci ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
lng
Jenis:  number
Bujur dalam derajat. Nilai di luar rentang [-180, 180] akan digabungkan 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 bola dunia.

Class LatLngBounds

Class google.maps.LatLngBounds

Instance LatLngBounds mewakili persegi panjang dalam koordinat geografis, termasuk koordinat yang melintasi meridian membujur 180 derajat.

Akses dengan memanggil const {LatLngBounds} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parameter: 
Membuat persegi panjang dari titik-titik di sudut barat daya dan timur lautnya.
contains
contains(latLng)
Parameter: 
Nilai Hasil:  boolean
Menampilkan true jika lintang/bujur yang diberikan berada dalam batas ini.
equals
equals(other)
Parameter: 
Nilai Hasil:  boolean
Menampilkan true jika batas ini kurang lebih sama dengan batas yang ditentukan.
extend
extend(point)
Parameter: 
Nilai Hasil:  LatLngBounds
Memperluas batas ini agar berisi titik yang diberikan.
getCenter
getCenter()
Parameter: Tidak ada
Nilai Hasil:  LatLng
Menghitung pusat LatLngBounds ini
getNorthEast
getNorthEast()
Parameter: Tidak ada
Nilai Hasil:  LatLng
Menampilkan sudut timur laut dari batas ini.
getSouthWest
getSouthWest()
Parameter: Tidak ada
Nilai Hasil:  LatLng
Menampilkan sudut barat daya dari batas ini.
intersects
intersects(other)
Parameter: 
Nilai Hasil:  boolean
Menampilkan true jika batas ini memiliki titik yang sama dengan batas lainnya.
isEmpty
isEmpty()
Parameter: Tidak ada
Nilai Hasil:  boolean
Menampilkan jika batas kosong.
toJSON
toJSON()
Parameter: Tidak ada
Nilai Hasil:  LatLngBoundsLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.
toSpan
toSpan()
Parameter: Tidak ada
Nilai Hasil:  LatLng
Mengonversi batas peta tertentu menjadi rentang lat/lng.
toString
toString()
Parameter: Tidak ada
Nilai Hasil:  string
Mengonversi menjadi string.
toUrlValue
toUrlValue([precision])
Parameter: 
  • precisionnumber optional
Nilai Hasil:  string
Menampilkan string dalam bentuk "lat_lo,lng_lo,lat_hi,lng_hi" untuk batas ini, dengan "lo" sesuai dengan sudut barat daya kotak pembatas, sedangkan "hi" sesuai dengan sudut timur laut kotak tersebut.
union
union(other)
Parameter: 
Nilai Hasil:  LatLngBounds
Memperluas batas ini agar memiliki gabungan batas ini dan batas yang ditentukan.
MAX_BOUNDS LatLngBounds untuk batas maksimum Bumi. Batas ini akan mencakup seluruh dunia.

Antarmuka LatLngBoundsLiteral

Antarmuka google.maps.LatLngBoundsLiteral

Literal objek diterima sebagai pengganti objek LatLngBounds di seluruh API. Ini otomatis dikonversi menjadi objek LatLngBounds. Semua south, west, north, dan east harus ditetapkan. Jika tidak, pengecualian akan ditampilkan.

east
Jenis:  number
Bujur timur dalam derajat. Nilai di luar rentang [-180, 180] akan digabungkan ke rentang [-180, 180). Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 190 akan dikonversi menjadi -170. Hal ini mencerminkan fakta bahwa garis bujur mengelilingi bola dunia.
north
Jenis:  number
Lintang utara dalam derajat. Nilai akan dikunci ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
south
Jenis:  number
Lintang selatan dalam derajat. Nilai akan dikunci ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
west
Jenis:  number
Bujur barat dalam derajat. Nilai di luar rentang [-180, 180] akan digabungkan ke rentang [-180, 180). Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 190 akan dikonversi menjadi -170. Hal ini mencerminkan fakta bahwa garis bujur mengelilingi bola dunia.

Class LatLngAltitude

Class google.maps.LatLngAltitude

LatLngAltitude adalah titik 3D dalam koordinat geografis: lintang, bujur, dan ketinggian.

  • Garis lintang berkisar 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, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
  • Rentang bujur antara -180 dan 180 derajat, inklusif. Nilai di atas atau di bawah rentang ini akan digabungkan 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 bola dunia.
  • Ketinggian diukur dalam meter. Nilai positif menunjukkan ketinggian di atas permukaan tanah, dan nilai negatif menunjukkan ketinggian di bawah permukaan tanah.

Class ini mengimplementasikan LatLngAltitudeLiteral.

Class ini mengimplementasikan LatLngLiteral.

Akses dengan memanggil const {LatLngAltitude} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parameter: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng Nilai inisialisasi.
  • noClampNoWrapboolean optional Apakah akan mempertahankan nilai inisialisasi, meskipun nilai tersebut mungkin tidak harus berupa nilai lintang yang valid dalam rentang [-90, 90] atau nilai bujur yang valid dalam rentang [-180, 180]. Defaultnya adalah false yang memungkinkan pembulatan garis lintang dan garis bujur.
altitude
Jenis:  number
Menampilkan ketinggian.
lat
Jenis:  number
Menampilkan garis lintang.
lng
Jenis:  number
Menampilkan bujur.
equals
equals(other)
Parameter: 
Nilai Hasil:  boolean Apakah kedua objek tersebut sama.
Fungsi perbandingan.
toJSON
toJSON()
Parameter: Tidak ada
Nilai Hasil:  LatLngAltitudeLiteral Representasi JSON dari objek ini.

Antarmuka LatLngAltitudeLiteral

Antarmuka google.maps.LatLngAltitudeLiteral

Literal objek diterima sebagai pengganti objek LatLngAltitude, sebagai kenyamanan, di banyak tempat. Ini dikonversi menjadi objek LatLngAltitude ketika Maps API menemukannya.

Antarmuka ini memperluas LatLngLiteral.

altitude
Jenis:  number
Default: 0
Jarak (dalam meter) di atas permukaan tanah. Nilai negatif berarti di bawah permukaan tanah.
lat
Jenis:  number
Lintang dalam derajat. Nilai akan dikunci ke rentang [-90, 90]. Artinya, jika nilai yang ditentukan kurang dari -90, nilainya akan ditetapkan ke -90. Dan jika nilainya lebih besar dari 90, nilai tersebut akan ditetapkan ke 90.
lng
Jenis:  number
Bujur dalam derajat. Nilai di luar rentang [-180, 180] akan digabungkan 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 bola dunia.

Class Point

Class google.maps.Point

Akses dengan memanggil const {Point} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.

Point
Point(x, y)
Parameter: 
  • xnumber
  • ynumber
Titik pada bidang dua dimensi.
x
Jenis:  number
Koordinat X
y
Jenis:  number
Koordinat Y
equals
equals(other)
Parameter: 
Nilai Hasil:  boolean
Membandingkan dua Poin
toString
toString()
Parameter: Tidak ada
Nilai Hasil:  string
Menampilkan representasi string dari Titik ini.

Class Size

Class google.maps.Size

Akses dengan memanggil const {Size} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.

Size
Size(width, height[, widthUnit, heightUnit])
Parameter: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Ukuran dua dimensi, dengan lebar adalah jarak pada sumbu x, dan tinggi adalah jarak pada sumbu y.
height
Jenis:  number
Tinggi sepanjang sumbu y, dalam piksel.
width
Jenis:  number
Lebar sepanjang sumbu x, dalam piksel.
equals
equals(other)
Parameter: 
Nilai Hasil:  boolean
Membandingkan dua Ukuran.
toString
toString()
Parameter: Tidak ada
Nilai Hasil:  string
Menampilkan representasi string dari Ukuran ini.

Antarmuka Padding

Antarmuka google.maps.Padding

bottom optional
Jenis:  number optional
Padding untuk bagian bawah, dalam piksel.
left optional
Jenis:  number optional
Padding untuk kiri, dalam piksel.
right optional
Jenis:  number optional
Padding untuk sisi kanan, dalam piksel.
top optional
Jenis:  number optional
Padding untuk bagian atas, dalam piksel.

Antarmuka CircleLiteral

Antarmuka google.maps.CircleLiteral

Literal objek yang mewakili lingkaran.

Antarmuka ini memperluas CircleOptions.

center
Bagian tengah Lingkaran.
radius
Jenis:  number
Radius dalam meter di permukaan bumi.
Diwariskan: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex