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