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.

Giao diện LatLngBoundsLiteral

google.maps.LatLngBoundsLiteralgiao 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ệ.

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.

Giao diện LatLngAltitudeLiteral

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

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.

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.

Giao diện Khoảng đệm

google.maps.Paddinggiao diện

Giao diện CircleLiteral

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

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.

Giao diện Orientation3DLiteral

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

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.

Giao diện Vector3DLiteral

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