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: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean 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: 
  • precisionnumber 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: 
Nilai yang Ditampilkan:  boolean
Menampilkan true jika batas ini kira-kira sama dengan batas yang diberikan.
extend
extend(point)
Parameter: 
Nilai yang Ditampilkan:  LatLngBounds
Memperluas batas ini untuk memuat titik yang diberikan.
getCenter
getCenter()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLng
Menghitung pusat LatLngBounds ini
getNorthEast
getNorthEast()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLng
Menampilkan sudut timur laut batas ini.
getSouthWest
getSouthWest()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLng
Menampilkan sudut barat daya batas ini.
intersects
intersects(other)
Parameter: 
Nilai yang Ditampilkan:  boolean
Menampilkan true jika batas ini berbagi titik dengan batas lainnya.
isEmpty
isEmpty()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  boolean
Menampilkan apakah batas kosong.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLngBoundsLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.
toSpan
toSpan()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLng
Mengonversi batas peta yang diberikan menjadi rentang lat/lng.
toString
toString()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string
Mengonversi ke string.
toUrlValue
toUrlValue([precision])
Parameter: 
  • precisionnumber optional
Nilai yang Ditampilkan:  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 yang Ditampilkan:  LatLngBounds
Memperluas batas ini untuk mencakup gabungan batas ini dan batas yang diberikan.

LatLngBoundsLiteral interface

google.maps.LatLngBoundsLiteral interface

Literal objek diterima sebagai pengganti objek LatLngBounds di seluruh API. Objek 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 dibulatkan 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 dunia.
north
Jenis:  number
Garis lintang utara 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.
south
Jenis:  number
Garis lintang selatan 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.
west
Jenis:  number
Bujur barat dalam derajat. Nilai di luar rentang [-180, 180] akan dibulatkan 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 dunia.

Class LatLngAltitude

Class google.maps.LatLngAltitude

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

  • 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.
  • 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|LatLng|LatLngLiteral Nilai inisialisasi.
  • noClampNoWrapboolean optional Apakah akan mempertahankan nilai inisialisasi, meskipun nilai tersebut mungkin tidak selalu berupa nilai lintang yang valid dalam rentang [-90, 90] atau nilai bujur yang valid dalam rentang [-180, 180]. Defaultnya adalah false yang mengaktifkan pengaitan lintang dan pembungkusan bujur.
altitude
Jenis:  number
Menampilkan ketinggian.
lat
Jenis:  number
Menampilkan garis lintang.
lng
Jenis:  number
Menampilkan bujur.
equals
equals(other)
Parameter: 
Nilai yang Ditampilkan:  boolean Apakah kedua objek sama.
Fungsi perbandingan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  LatLngAltitudeLiteral Representasi JSON dari objek ini.

LatLngAltitudeLiteral interface

google.maps.LatLngAltitudeLiteral interface

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

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

Point class

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: 
  • otherPoint optional
Nilai yang Ditampilkan:  boolean
Membandingkan dua Titik
toString
toString()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string
Menampilkan representasi string dari Point 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 yang Ditampilkan:  boolean
Membandingkan dua Ukuran.
toString
toString()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string
Menampilkan representasi string dari Ukuran ini.

Antarmuka Padding

google.maps.Padding interface

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 kanan, dalam piksel.
top optional
Jenis:  number optional
Padding untuk bagian atas, dalam piksel.

Antarmuka CircleLiteral

google.maps.CircleLiteral interface

Literal objek yang merepresentasikan lingkaran.

Antarmuka ini memperluas CircleOptions.

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

Orientation3D class

Class google.maps.Orientation3D

Orientation3D adalah vektor tiga dimensi yang digunakan untuk transformasi rotasi matematika standar di sepanjang heading, kemiringan, dan putaran.

  • heading adalah sudut dalam rentang [0, 360) derajat.
  • kemiringan adalah sudut dalam rentang [0, 360) derajat.
  • roll adalah sudut dalam rentang [0, 360) derajat.

Class ini mengimplementasikan Orientation3DLiteral.

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

Orientation3D
Orientation3D(value)
Parameter: 
heading
Jenis:  number
Default: 0
Rotasi di sekitar sumbu z (tegak lurus terhadap permukaan Bumi). Nilai 0 (default) sama dengan Utara. Rotasi positif searah jarum jam di sekitar sumbu z dan ditentukan dalam derajat dari 0 hingga 360. Nilai di atas atau di bawah rentang ini akan dibulatkan agar berada dalam rentang. Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 530 juga akan dikonversi menjadi 170.
roll
Jenis:  number
Default: 0
Rotasi di sekitar sumbu y. Rotasi positif searah jarum jam di sekitar sumbu y dan ditentukan dalam derajat dari 0 hingga 360. Nilai di atas atau di bawah rentang ini akan dibulatkan agar berada dalam rentang. Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 530 juga akan dikonversi menjadi 170.
tilt
Jenis:  number
Default: 0
Rotasi di sekitar sumbu x. Rotasi positif searah jarum jam di sekitar sumbu x dan ditentukan dalam derajat dari 0 hingga 360. Nilai di atas atau di bawah rentang ini akan dibulatkan agar berada dalam rentang. Misalnya, nilai -190 akan dikonversi menjadi 170. Nilai 530 juga akan dikonversi menjadi 170.
equals
equals(other)
Parameter: 
Nilai yang Ditampilkan:  boolean Apakah kedua objek sama.
Fungsi perbandingan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Orientation3DLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.

Orientation3DLiteral interface

google.maps.Orientation3DLiteral interface

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

heading optional
Jenis:  number optional
Rotasi di sekitar sumbu z (tegak lurus terhadap permukaan Bumi). Nilai 0 (default) sama dengan Utara. Rotasi positif searah jarum jam di sekitar sumbu z dan ditentukan dalam derajat dari 0 hingga 360.
roll optional
Jenis:  number optional
Rotasi di sekitar sumbu y. Rotasi positif searah jarum jam di sekitar sumbu y dan ditentukan dalam derajat dari 0 hingga 360.
tilt optional
Jenis:  number optional
Rotasi di sekitar sumbu x. Rotasi positif searah jarum jam di sekitar sumbu x dan ditentukan dalam derajat dari 0 hingga 360.

Class Vector3D

Class google.maps.Vector3D

Vector3D adalah vektor tiga dimensi yang digunakan untuk operasi matematika standar seperti penskalaan batas objek tiga dimensi di sepanjang sumbu x, y, dan z lokal.

  • x adalah bilangan riil.
  • y adalah bilangan riil.
  • z adalah bilangan riil.

Class ini mengimplementasikan Vector3DLiteral.

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

Vector3D
Vector3D(value)
Parameter: 
x
Jenis:  number
Komponen X dari vektor tiga dimensi.
y
Jenis:  number
Komponen Y dari vektor tiga dimensi.
z
Jenis:  number
Komponen Z dari vektor tiga dimensi.
equals
equals(other)
Parameter: 
Nilai yang Ditampilkan:  boolean
Fungsi perbandingan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Vector3DLiteral
Mengonversi ke representasi JSON. Fungsi ini dimaksudkan untuk digunakan melalui JSON.stringify.

Antarmuka Vector3DLiteral

google.maps.Vector3DLiteral interface

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

x
Jenis:  number
Komponen X dari vektor tiga dimensi.
y
Jenis:  number
Komponen Y dari vektor tiga dimensi.
z
Jenis:  number
Komponen Z dari vektor tiga dimensi.