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ị nằm ngoài khoảng này 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ị này sẽ được đặt thành 90.
- Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị nằm trên hoặc dưới phạm vi này sẽ được bao bọc để 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 toàn cầu.
Xin 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
, do đó, 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 dựng cũng chấp nhận các đối tượng LatLngLiteral
và LatLng
. Nếu một thực thể LatLng
được truyền đến hàm khởi tạo, thì một bản sao sẽ được tạo.
Sau đâ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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Tham số:
Tạo một đố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 để cho phép các giá trị nằm ngoài phạm vi này. Lưu ý thứ tự của vĩ độ và kinh độ. |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean Hàm so sánh. |
lat |
lat() Tham số: Không có
Giá trị trả về:
number Trả về vĩ độ tính bằng độ. |
lng |
lng() Tham số: Không có
Giá trị trả về:
number Trả về kinh độ theo độ. |
toJSON |
toJSON() Tham số: Không có
Giá trị trả về:
LatLngLiteral Chuyển đổi thành biểu diễn JSON. Bạn có thể dùng hàm này thông qua JSON.stringify . |
toString |
toString() Tham số: Không có
Giá trị trả về:
string Chuyển đổi thành giá trị đại diện chuỗi. |
toUrlValue |
toUrlValue([precision]) Tham số:
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ị vĩ độ/kinh độ đến 6 chữ số thập phân. |
Giao diện LatLngLiteral
google.maps.LatLngLiteral
giao diện
Các đối tượng chữ được chấp nhận thay cho các đối tượng LatLng
, vì sự thuận tiện ở nhiều nơi. Các đối tượng này sẽ được chuyển đổi thành các đối tượng LatLng
khi Maps API gặp phải chúng.
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ợ các đối tượng LatLng theo nghĩa đen.
Thuộc tính | |
---|---|
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ị này sẽ được đặt thành 90. |
lng |
Loại:
number Kinh độ tính bằng độ. Các giá trị nằm ngoài khoảng [-180, 180] sẽ được bao bọc để nằm trong khoảng 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 toàn cầu. |
Lớp LatLngBounds
Lớp google.maps.LatLngBounds
Một thực thể LatLngBounds
biểu thị một hình chữ nhật theo toạ độ địa lý, bao gồm cả hình chữ nhật cắt ngang đường kinh tuyến 180 độ.
Truy cập bằng cách gọi const {LatLngBounds} = await google.maps.importLibrary("core")
.
Xem Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Tham số:
Tạo một hình chữ nhật từ các điểm ở góc tây nam và đông bắc của hình chữ nhật đó. |
Hằng số | |
---|---|
MAX_BOUNDS |
LatLngBounds cho ranh giới tối đa của Trái Đất. Các ranh giới này sẽ bao gồm toàn bộ địa cầu. |
Phương thức | |
---|---|
contains |
contains(latLng) Tham số:
Giá trị trả về:
boolean Trả về true nếu vĩ độ/kinh độ đã cho nằm trong ranh giới này. |
equals |
equals(other) Tham số:
Giá trị trả về:
boolean Trả về true nếu ranh giới này xấp xỉ bằng ranh giới đã cho. |
extend |
extend(point) Tham số:
Giá trị trả về:
LatLngBounds Mở rộng ranh giới này để chứa điểm đã cho. |
getCenter |
getCenter() Tham số: Không có
Giá trị trả về:
LatLng Tính toán tâm của LatLngBounds này |
getNorthEast |
getNorthEast() Tham số: Không có
Giá trị trả về:
LatLng Trả về góc Đông Bắc của ranh giới này. |
getSouthWest |
getSouthWest() Tham số: Không có
Giá trị trả về:
LatLng Trả về góc dưới bên trái của ranh giới này. |
intersects |
intersects(other) Tham số:
Giá trị trả về:
boolean Trả về true nếu ranh giới này có điểm chung với ranh giới khác. |
isEmpty |
isEmpty() Tham số: Không có
Giá trị trả về:
boolean Trả về nếu các ranh giới trống. |
toJSON |
toJSON() Tham số: Không có
Giá trị trả về:
LatLngBoundsLiteral Chuyển đổi thành biểu diễn JSON. Bạn có thể dùng hàm này thông qua JSON.stringify . |
toSpan |
toSpan() Tham số: Không có
Giá trị trả về:
LatLng Chuyển đổi ranh giới bản đồ đã cho thành khoảng vĩ độ/kinh độ. |
toString |
toString() Tham số: Không có
Giá trị trả về:
string Chuyển đổi thành chuỗi. |
toUrlValue |
toUrlValue([precision]) Tham số:
Giá trị trả về:
string Trả về một chuỗi có dạng "lat_lo,lng_lo,lat_hi,lng_hi" cho ranh giới 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) Tham số:
Giá trị trả về:
LatLngBounds Mở rộng ranh giới này để chứa hợp của ranh giới này và ranh giới đã cho. |
Giao diện LatLngBoundsLiteral
google.maps.LatLngBoundsLiteral
giao diện
Các đối tượng chữ đượ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 sẽ tự động chuyển đổi thành các đối tượng LatLngBounds
. Bạn phải đặt tất cả south
, west
, north
và east
, nếu không, hệ thống sẽ gửi một trường hợp ngoại lệ.
Thuộc tính | |
---|---|
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 chuyển sang 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 toàn 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ị này 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ị này 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 chuyển sang 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 toàn cầu. |
Lớp LatLngAltitude
Lớp google.maps.LatLngAltitude
LatLngAltitude
là một điểm 3D trong toạ độ địa lý: vĩ độ, kinh độ và độ cao.
- Vĩ độ nằm trong khoảng từ -90 đến 90 độ. Các giá trị nằm ngoài khoảng này 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ị này sẽ được đặt thành 90.
- Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị nằm trên hoặc dưới phạm vi này sẽ được bao bọc để 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 toàn cầu.
- Độ cao được đo bằng mét. Giá trị dương biểu thị độ cao so với mặt đất, còn giá trị âm biểu thị độ cao bên dưới bề 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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap]) Tham số:
|
Thuộc tính | |
---|---|
altitude |
Loại:
number Trả về độ cao. |
lat |
Loại:
number Trả về vĩ độ. |
lng |
Loại:
number Trả về kinh độ. |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean Hai đối tượng có bằng nhau hay không.Hàm so sánh. |
toJSON |
toJSON() Tham số: Không có
Giá trị trả về:
LatLngAltitudeLiteral Biểu thị JSON của đối tượng này. |
Giao diện LatLngAltitudeLiteral
google.maps.LatLngAltitudeLiteral
giao diện
Các đối tượng chữ được chấp nhận thay cho các đối tượng LatLngAltitude
, vì sự thuận tiện ở nhiều nơi. Các đối tượng này sẽ được chuyển đổi thành các đối tượng LatLngAltitude
khi Maps API gặp phải chúng.
Giao diện này mở rộng LatLngLiteral
.
Thuộc tính | |
---|---|
altitude |
Loại:
number Mặc định:
0 Khoảng cách (tính bằng mét) so với bề mặt đất. Giá trị âm có nghĩa là bên dưới bề 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ị này sẽ được đặt thành 90. |
lng |
Loại:
number Kinh độ tính bằng độ. Các giá trị nằm ngoài khoảng [-180, 180] sẽ được bao bọc để nằm trong khoảng 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 toàn 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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
Point |
Point(x, y) Tham số:
Một điểm trên mặt phẳng hai chiều. |
Thuộc tính | |
---|---|
x |
Loại:
number Toạ độ X |
y |
Loại:
number Toạ độ Y |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean So sánh 2 điểm |
toString |
toString() Tham số: Không có
Giá trị trả về:
string Trả về một chuỗi biểu thị Point 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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Tham số:
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. |
Thuộc tính | |
---|---|
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. |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean So sánh 2 kích thước. |
toString |
toString() Tham số: Không có
Giá trị trả về:
string Trả về một chuỗi biểu thị Size này. |
Giao diện Khoảng đệm
google.maps.Padding
giao diện
Thuộc tính | |
---|---|
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 cho 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
google.maps.CircleLiteral
giao diện
Đối tượng ký tự đại diện biểu thị một hình tròn.
Giao diện này mở rộng CircleOptions
.
Thuộc tính | |
---|---|
center |
Loại:
LatLng|LatLngLiteral Tâm của Vòng kết nối. |
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 tiêu chuẩn theo hướng, độ nghiêng và độ xoay.
- heading là một góc trong phạm vi [0, 360) độ.
- độ nghiêng là một góc trong phạm vi [0, 360) độ.
- roll là một góc trong phạm vi [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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
Orientation3D |
Orientation3D(value) Tham số:
|
Thuộc tính | |
---|---|
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) tương đương với hướng Bắc. Phép xoay dương là phép xoay theo chiều kim đồng hồ quanh trục z và được chỉ định bằng độ từ 0 đến 360. Các giá trị nằm trên hoặc dưới phạm vi này sẽ được bao bọc để 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. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục y và được chỉ định theo độ từ 0 đến 360. Các giá trị nằm trên hoặc dưới phạm vi này sẽ được bao bọc để 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. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục x và được chỉ định bằng độ từ 0 đến 360. Các giá trị nằm trên hoặc dưới phạm vi này sẽ được bao bọc để 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. |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean Hai đối tượng có bằng nhau hay không.Hàm so sánh. |
toJSON |
toJSON() Tham số: Không có
Giá trị trả về:
Orientation3DLiteral Chuyển đổi thành biểu diễn JSON. Bạn có thể dùng hàm này thông qua JSON.stringify. |
Giao diện Orientation3DLiteral
google.maps.Orientation3DLiteral
giao diện
Các đối tượng chữ được chấp nhận thay cho các đối tượng Orientation3D
, vì sự thuận tiện ở nhiều nơi. Các đối tượng này sẽ được chuyển đổi thành các đối tượng Orientation3D
khi Maps API gặp phải chúng.
Thuộc tính | |
---|---|
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) tương đương với hướng Bắc. Phép xoay dương là phép xoay theo chiều kim đồng hồ quanh trục z và được chỉ định bằng độ từ 0 đến 360. |
roll optional |
Loại:
number optional Xoay quanh trục y. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục y và được chỉ định theo độ từ 0 đến 360. |
tilt optional |
Loại:
number optional Xoay quanh trục x. Góc xoay dương là góc xoay theo chiều kim đồng hồ 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 được dùng cho các phép toán học tiêu chuẩn, chẳng hạn như điều chỉnh tỷ lệ ranh giới của đối tượng ba chiều dọc theo các 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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
Vector3D |
Vector3D(value) Tham số:
|
Thuộc tính | |
---|---|
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. |
Phương thức | |
---|---|
equals |
equals(other) Tham số:
Giá trị trả về:
boolean Hàm so sánh. |
toJSON |
toJSON() Tham số: Không có
Giá trị trả về:
Vector3DLiteral Chuyển đổi thành biểu diễn JSON. Bạn có thể dùng hàm này thông qua JSON.stringify. |
Giao diện Vector3DLiteral
google.maps.Vector3DLiteral
giao diện
Các đối tượng chữ được chấp nhận thay cho các đối tượng Vector3D
, vì sự thuận tiện ở nhiều nơi. Các đối tượng này sẽ được chuyển đổi thành các đối tượng Vector3D
khi Maps API gặp phải chúng.
Thuộc tính | |
---|---|
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. |