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ị 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.
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, sau đó là kinh độ.
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.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Tham số: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
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 độ.
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ố: 
  • precision:  number 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ị vĩ độ/kinh độ đến 6 chữ số thập phân.

Giao diện LatLngLiteral

google.maps.LatLngLiteralgiao 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.
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