Coordinates

Lớp LatLng

Lớp google.maps.LatLng

LatLng là một điểm trong toạ độ địa lý: vĩ độ và kinh độ.

  • Vĩ độ nằm trong khoảng từ -90 đến 90 độ. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được giới hạn ở phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
  • Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói lại để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.
Mặc dù phép chiếu bản đồ mặc định liên kết kinh độ với toạ độ x của bản đồ và vĩ độ với toạ độ y, nhưng toạ độ vĩ độ luôn được viết trước, theo sau là kinh độ.
Lưu ý rằng bạn không thể sửa đổi toạ độ của LatLng. Nếu muốn tính toán một điểm khác, bạn phải tạo một điểm mới.

Hầu hết các phương thức chấp nhận đối tượng LatLng cũng chấp nhận đối tượng LatLngLiteral, vì vậy, các phương thức sau đây là tương đương:

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

Hàm khởi tạo cũng chấp nhận các đối tượng LatLngLiteralLatLng. Nếu một thực thể LatLng được truyền vào hàm khởi tạo, thì một bản sao sẽ được tạo.

Dưới đây là các lệnh gọi có thể có đến hàm khởi tạo:

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

Truy cập bằng cách gọi const {LatLng} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Thông số: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Tạo đối tượng LatLng đại diện cho một điểm địa lý. Vĩ độ được chỉ định bằng độ trong phạm vi [-90, 90]. Kinh độ được chỉ định bằng độ trong phạm vi [-180, 180). Đặt noClampNoWrap thành true để bật các giá trị nằm ngoài phạm vi này. Lưu ý thứ tự của vĩ độ và kinh độ.
equals
equals(other)
Thông số: 
Giá trị trả về:  boolean
Hàm so sánh.
lat
lat()
Thông số:  Không có
Giá trị trả về:  number
Trả về vĩ độ theo độ.
lng
lng()
Thông số:  Không có
Giá trị trả về:  number
Trả về kinh độ theo độ.
toJSON
toJSON()
Thông số:  Không có
Giá trị trả về:  LatLngLiteral
Chuyển đổi sang bản trình bày JSON. Hàm này được dùng thông qua JSON.stringify.
toString
toString()
Thông số:  Không có
Giá trị trả về:  string
Chuyển đổi thành giá trị đại diện chuỗi.
toUrlValue
toUrlValue([precision])
Thông số: 
  • precisionnumber optional
Giá trị trả về:  string
Trả về một chuỗi có dạng "lat,lng" cho LatLng này. Theo mặc định, chúng tôi làm tròn các giá trị lat/lng thành 6 chữ số thập phân.

Giao diện LatLngLiteral

Giao diện google.maps.LatLngLiteral

Để thuận tiện, ở nhiều nơi, bạn có thể dùng giá trị cố định đối tượng thay cho đối tượng LatLng. Các đối tượng này được chuyển đổi thành đối tượng LatLng khi API Maps gặp phải.

Ví dụ:

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

Thư viện Geometry không hỗ trợ giá trị cố định đối tượng LatLng.

lat
Loại:  number
Vĩ độ tính bằng độ. Các giá trị sẽ được giới hạn trong khoảng [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
lng
Loại:  number
Kinh độ tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói lại để nằm trong phạm vi này. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp LatLngBounds

Lớp google.maps.LatLngBounds

Một thực thể LatLngBounds đại diện cho một hình chữ nhật theo toạ độ địa lý, bao gồm cả một hình chữ nhật cắt qua kinh tuyến 180 độ.

Truy cập bằng cách gọi const {LatLngBounds} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Thông số: 
Tạo một hình chữ nhật từ các điểm ở góc tây nam và đông bắc.
MAX_BOUNDS LatLngBounds cho giới hạn tối đa của Trái Đất. Các giới hạn này sẽ bao gồm toàn bộ địa cầu.
contains
contains(latLng)
Thông số: 
Giá trị trả về:  boolean
Trả về true nếu lat/lng đã cho nằm trong giới hạn này.
equals
equals(other)
Thông số: 
Giá trị trả về:  boolean
Trả về true nếu giới hạn này gần bằng giới hạn đã cho.
extend
extend(point)
Thông số: 
Giá trị trả về:  LatLngBounds
Mở rộng giới hạn này để chứa điểm đã cho.
getCenter
getCenter()
Thông số:  Không có
Giá trị trả về:  LatLng
Tính toán tâm của LatLngBounds này
getNorthEast
getNorthEast()
Thông số:  Không có
Giá trị trả về:  LatLng
Trả về góc đông bắc của giới hạn này.
getSouthWest
getSouthWest()
Thông số:  Không có
Giá trị trả về:  LatLng
Trả về góc tây nam của giới hạn này.
intersects
intersects(other)
Thông số: 
Giá trị trả về:  boolean
Trả về true nếu giới hạn này có điểm chung với giới hạn khác.
isEmpty
isEmpty()
Thông số:  Không có
Giá trị trả về:  boolean
Trả về nếu các giới hạn này trống.
toJSON
toJSON()
Thông số:  Không có
Giá trị trả về:  LatLngBoundsLiteral
Chuyển đổi sang bản trình bày JSON. Hàm này được dùng thông qua JSON.stringify.
toSpan
toSpan()
Thông số:  Không có
Giá trị trả về:  LatLng
Chuyển đổi các giới hạn bản đồ đã cho thành một span lat/lng.
toString
toString()
Thông số:  Không có
Giá trị trả về:  string
Chuyển đổi thành chuỗi.
toUrlValue
toUrlValue([precision])
Thông số: 
  • precisionnumber optional
Giá trị trả về:  string
Trả về một chuỗi có dạng "lat_lo,lng_lo,lat_hi,lng_hi" cho các giới hạn này, trong đó "lo" tương ứng với góc tây nam của hộp giới hạn, còn "hi" tương ứng với góc đông bắc của hộp đó.
union
union(other)
Thông số: 
Giá trị trả về:  LatLngBounds
Mở rộng giới hạn này để chứa tập hợp hợp nhất của giới hạn này và giới hạn đã cho.

Giao diện LatLngBoundsLiteral

Giao diện google.maps.LatLngBoundsLiteral

Các giá trị cố định đối tượng được chấp nhận thay cho các đối tượng LatLngBounds trong toàn bộ API. Các đối tượng này được tự động chuyển đổi thành đối tượng LatLngBounds. Bạn phải đặt tất cả south, west, northeast, nếu không, hệ thống sẽ gửi một trường hợp ngoại lệ.

east
Loại:  number
Kinh độ đông tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói vào phạm vi [-180, 180). Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.
north
Loại:  number
Vĩ độ bắc tính bằng độ. Các giá trị sẽ được giới hạn trong khoảng [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
south
Loại:  number
Vĩ độ nam tính bằng độ. Các giá trị sẽ được giới hạn trong khoảng [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
west
Loại:  number
Kinh độ tây tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói vào phạm vi [-180, 180). Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp LatLngAltitude

Lớp google.maps.LatLngAltitude

LatLngAltitude là một điểm 3D theo toạ độ địa lý: vĩ độ, kinh độ và độ cao.

  • Vĩ độ nằm trong khoảng từ -90 đến 90 độ. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được giới hạn ở phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
  • Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói lại để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.
  • Độ cao được đo bằng mét. Giá trị dương biểu thị độ cao trên mặt đất và giá trị âm biểu thị độ cao bên dưới mặt đất.

Lớp này triển khai LatLngAltitudeLiteral.

Lớp này triển khai LatLngLiteral.

Truy cập bằng cách gọi const {LatLngAltitude} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Thông số: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Giá trị khởi tạo.
  • noClampNoWrapboolean optional Liệu có giữ nguyên các giá trị khởi chạy hay không, ngay cả khi các giá trị đó không nhất thiết phải là giá trị vĩ độ hợp lệ trong khoảng [-90, 90] hoặc giá trị kinh độ hợp lệ trong khoảng [-180, 180]. Giá trị mặc định là false, cho phép kẹp vĩ độ và gói kinh độ.
altitude
Loại:  number
Trả về độ cao.
lat
Loại:  number
Trả về vĩ độ.
lng
Loại:  number
Trả về kinh độ.
equals
equals(other)
Thông số: 
  • otherLatLngAltitude optional Một đối tượng LatLngAltitude khác.
Giá trị trả về:  boolean Liệu hai đối tượng có bằng nhau hay không.
Hàm so sánh.
toJSON
toJSON()
Thông số:  Không có
Giá trị trả về:  LatLngAltitudeLiteral Một JSON đại diện cho đối tượng này.

Giao diện LatLngAltitudeLiteral

Giao diện google.maps.LatLngAltitudeLiteral

Để thuận tiện, ở nhiều nơi, bạn có thể dùng giá trị cố định đối tượng thay cho đối tượng LatLngAltitude. Các đối tượng này được chuyển đổi thành đối tượng LatLngAltitude khi API Maps gặp phải.

Giao diện này mở rộng LatLngLiteral.

altitude
Loại:  number
Mặc định: 0
Khoảng cách (tính bằng mét) so với mặt đất. Giá trị âm có nghĩa là bên dưới mặt đất.
lat
Loại:  number
Vĩ độ tính bằng độ. Các giá trị sẽ được giới hạn trong khoảng [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị đó sẽ được đặt thành 90.
lng
Loại:  number
Kinh độ tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói lại để nằm trong phạm vi này. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp Point

Lớp google.maps.Point

Truy cập bằng cách gọi const {Point} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Point
Point(x, y)
Thông số: 
  • xnumber
  • ynumber
Một điểm trên mặt phẳng hai chiều.
x
Loại:  number
Toạ độ X
y
Loại:  number
Toạ độ Y
equals
equals(other)
Thông số: 
  • otherPoint optional
Giá trị trả về:  boolean
So sánh hai Điểm
toString
toString()
Thông số:  Không có
Giá trị trả về:  string
Trả về một chuỗi đại diện cho Điểm này.

Lớp Kích thước

Lớp google.maps.Size

Truy cập bằng cách gọi const {Size} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Size
Size(width, height[, widthUnit, heightUnit])
Thông số: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Kích thước hai chiều, trong đó chiều rộng là khoảng cách trên trục x và chiều cao là khoảng cách trên trục y.
height
Loại:  number
Chiều cao dọc theo trục y, tính bằng pixel.
width
Loại:  number
Chiều rộng dọc theo trục x, tính bằng pixel.
equals
equals(other)
Thông số: 
Giá trị trả về:  boolean
So sánh hai Kích thước.
toString
toString()
Thông số:  Không có
Giá trị trả về:  string
Trả về một chuỗi đại diện cho Kích thước này.

Giao diện Khoảng đệm

Giao diện google.maps.Padding

bottom optional
Loại:  number optional
Khoảng đệm cho phần dưới cùng, tính bằng pixel.
left optional
Loại:  number optional
Khoảng đệm cho bên trái, tính bằng pixel.
right optional
Loại:  number optional
Khoảng đệm bên phải, tính bằng pixel.
top optional
Loại:  number optional
Khoảng đệm cho phần trên cùng, tính bằng pixel.

Giao diện CircleLiteral

Giao diện google.maps.CircleLiteral

Đối tượng cố định đại diện cho một vòng tròn.

Giao diện này mở rộng CircleOptions.

center
Tâm của Vòng tròn.
radius
Loại:  number
Bán kính tính bằng mét trên bề mặt Trái Đất.
Kế thừa: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Lớp Orientation3D

Lớp google.maps.Orientation3D

Orientation3D là một vectơ ba chiều dùng cho các phép biến đổi xoay toán học chuẩn theo hướng, độ nghiêng và độ nghiêng.

  • heading là một góc trong phạm vi [0, 360) độ.
  • độ nghiêng là một góc trong khoảng [0, 360) độ.
  • roll là một góc trong khoảng [0, 360) độ.

Lớp này triển khai Orientation3DLiteral.

Truy cập bằng cách gọi const {Orientation3D} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Orientation3D
Orientation3D(value)
Thông số: 
heading
Loại:  number
Mặc định: 0
Xoay quanh trục z (vuông góc với bề mặt Trái Đất). Giá trị 0 (mặc định) bằng Bắc. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục z và được chỉ định theo độ từ 0 đến 360. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói lại để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.
roll
Loại:  number
Mặc định: 0
Xoay quanh trục y. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục y và được chỉ định theo độ từ 0 đến 360. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói lại để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.
tilt
Loại:  number
Mặc định: 0
Xoay quanh trục x. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục x và được chỉ định bằng độ từ 0 đến 360. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói lại để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.
equals
equals(other)
Thông số: 
Giá trị trả về:  boolean Liệu hai đối tượng có bằng nhau hay không.
Hàm so sánh.
toJSON
toJSON()
Thông số:  Không có
Giá trị trả về:  Orientation3DLiteral
Chuyển đổi sang bản trình bày JSON. Bạn nên sử dụng hàm này thông qua JSON.stringify.

Giao diện Orientation3DLiteral

Giao diện google.maps.Orientation3DLiteral

Để thuận tiện, ở nhiều nơi, bạn có thể dùng giá trị cố định đối tượng thay cho đối tượng Orientation3D. Các đối tượng này được chuyển đổi thành đối tượng Orientation3D khi API Maps gặp phải.

heading optional
Loại:  number optional
Xoay quanh trục z (vuông góc với bề mặt Trái Đất). Giá trị 0 (mặc định) bằng Bắc. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục z và được chỉ định theo độ từ 0 đến 360.
roll optional
Loại:  number optional
Xoay quanh trục y. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục y và được chỉ định theo độ từ 0 đến 360.
tilt optional
Loại:  number optional
Xoay quanh trục x. Độ xoay dương là theo chiều kim đồng hồ xung quanh trục x và được chỉ định bằng độ từ 0 đến 360.

Lớp Vector3D

Lớp google.maps.Vector3D

Vector3D là một vectơ ba chiều dùng cho các phép toán học chuẩn như điều chỉnh tỷ lệ giới hạn của đối tượng ba chiều dọc theo trục x, y và z cục bộ.

  • x là một số thực.
  • y là một số thực.
  • z là một số thực.

Lớp này triển khai Vector3DLiteral.

Truy cập bằng cách gọi const {Vector3D} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Vector3D
Vector3D(value)
Thông số: 
x
Loại:  number
Thành phần X của vectơ ba chiều.
y
Loại:  number
Thành phần Y của vectơ ba chiều.
z
Loại:  number
Thành phần Z của vectơ ba chiều.
equals
equals(other)
Thông số: 
Giá trị trả về:  boolean
Hàm so sánh.
toJSON
toJSON()
Thông số:  Không có
Giá trị trả về:  Vector3DLiteral
Chuyển đổi sang bản trình bày JSON. Bạn nên sử dụng hàm này thông qua JSON.stringify.

Giao diện Vector3DLiteral

Giao diện google.maps.Vector3DLiteral

Để thuận tiện, ở nhiều nơi, bạn có thể dùng giá trị cố định đối tượng thay cho đối tượng Vector3D. Các đối tượng này được chuyển đổi thành đối tượng Vector3D khi API Maps gặp phải.

x
Loại:  number
Thành phần X của vectơ ba chiều.
y
Loại:  number
Thành phần Y của vectơ ba chiều.
z
Loại:  number
Thành phần Z của vectơ ba chiều.