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.