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.

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.

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.

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.