Thông báo: Kiểu bản đồ cơ sở mới sắp ra mắt trên Nền tảng Google Maps. Bản cập nhật này về kiểu bản đồ bao gồm bảng màu mặc định mới, ghim hiện đại và các điểm cải tiến về trải nghiệm và khả năng sử dụng bản đồ. Tất cả kiểu bản đồ sẽ được tự động cập nhật vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn sử dụng sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Geometry Library

Không gian tên encoding

Không gian tên google.maps.geometry.encoding

Tiện ích để mã hoá và giải mã đường đa tuyến.

Truy cập bằng cách gọi const {encoding} = await google.maps.importLibrary("geometry"). Xem phần Thư viện trong API Maps JavaScript.

Phương thức tĩnh
`decodePath`	`decodePath(encodedPath)` Thông số: `encodedPath`: `string` Giá trị trả về: `Array<LatLng>` Giải mã chuỗi đường dẫn đã mã hoá thành một trình tự LatLng.
`encodePath`	`encodePath(path)` Thông số: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` Giá trị trả về: `string` Mã hoá một trình tự LatLng thành một chuỗi đường dẫn được mã hoá.

Không gian tên globular

Không gian tên google.maps.geometry.spherical

Các hàm tiện ích để tính toán góc, khoảng cách và diện tích geodesic. Bán kính mặc định là bán kính Trái Đất là 6378137 mét.

Truy cập bằng cách gọi const {spherical} = await google.maps.importLibrary("geometry"). Xem phần Thư viện trong API Maps JavaScript.

Phương thức tĩnh
`computeArea`	`computeArea(path[, radiusOfSphere])` Thông số: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` Giá trị trả về: `number` Trả về diện tích chưa ký của một đường dẫn kín, trong phạm vi [0, 2×pi×bán kính²]. Diện tích được tính toán sử dụng cùng đơn vị với bán kính. `radiusOfSphere` mặc định là bán kính Trái Đất tính bằng mét, trong trường hợp này diện tích sẽ tính bằng mét vuông. Khi truyền `Circle`, bạn phải đặt `radius` thành một giá trị không âm. Ngoài ra, Vòng tròn không được bao phủ quá 100% hình cầu. Và khi truyền `LatLngBounds`, LatLng phía nam không được nằm ở phía bắc LatLng phía bắc.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` Thông số: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` Giá trị trả về: `number` Trả về khoảng cách, tính bằng mét, giữa hai LatLng. Bạn có thể tuỳ ý chỉ định bán kính tuỳ chỉnh. Bán kính mặc định là bán kính của Trái Đất.
`computeHeading`	`computeHeading(from, to)` Thông số: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Giá trị trả về: `number` Trả về hướng từ một LatLng đến một LatLng khác. Hướng được biểu thị bằng độ theo chiều kim đồng hồ từ Bắc trong phạm vi [-180,180).
`computeLength`	`computeLength(path[, radius])` Thông số: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Giá trị trả về: `number` Trả về độ dài của đường dẫn đã cho.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` Thông số: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Giá trị trả về: `LatLng` Trả về LatLng thu được từ việc di chuyển một khoảng cách từ điểm gốc theo hướng đã chỉ định (biểu thị bằng độ theo chiều kim đồng hồ từ hướng bắc).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` Thông số: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Giá trị trả về: `LatLng\|null` Trả về vị trí ban đầu khi được cung cấp đích đến LatLng, quãng đường đã đi và hướng ban đầu. Hướng được biểu thị bằng độ theo chiều kim đồng hồ từ hướng Bắc. Hàm này trả về `null` khi không có giải pháp nào.
`computeSignedArea`	`computeSignedArea(loop[, radius])` Thông số: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Giá trị trả về: `number` Trả về diện tích đã ký của một đường dẫn kín, trong đó chiều kim đồng hồ là dương, trong phạm vi [-2×pi×bán kính², 2×pi×bán kính²]. Diện tích được tính sử dụng cùng đơn vị với bán kính. Bán kính mặc định là bán kính Trái Đất tính bằng mét, trong trường hợp này diện tích sẽ tính bằng mét vuông. Diện tích được tính bằng phương thức chuyển song song; chuyển song song xung quanh một đường dẫn kín trên hình cầu đơn vị xoắn theo một góc bằng diện tích được bao bọc bởi đường dẫn. Phương pháp này đơn giản, chính xác và mạnh mẽ hơn so với phương pháp tam giác hoá bằng Girard, l'Huilier hoặc Eriksson trên mỗi tam giác. Cụ thể, vì không tạo tam giác nên phương thức này không gặp phải sự không ổn định, ngoại trừ trường hợp không thể tránh khỏi khi một cạnh (không phải đường chéo) của đa giác trải dài 180 độ.
`interpolate`	`interpolate(from, to, fraction)` Thông số: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` Giá trị trả về: `LatLng` Trả về LatLng nằm ở một phần nhất định trên đường đi giữa LatLng gốc và LatLng đích.

Không gian tên poly

Không gian tên google.maps.geometry.poly

Các hàm tiện ích cho các phép tính liên quan đến đa giác và đa tuyến.

Truy cập bằng cách gọi const {poly} = await google.maps.importLibrary("geometry"). Xem phần Thư viện trong API Maps JavaScript.

Phương thức tĩnh
`containsLocation`	`containsLocation(point, polygon)` Thông số: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Giá trị trả về: `boolean` Tính toán xem điểm đã cho có nằm bên trong đa giác đã chỉ định hay không.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Thông số: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` Giá trị trả về: `boolean` Tính toán xem điểm đã cho có nằm trên hoặc gần một đường đa tuyến hay cạnh của đa giác hay không, trong một dung sai đã chỉ định. Trả về `true` khi chênh lệch giữa vĩ độ và kinh độ của điểm được cung cấp và điểm gần nhất trên cạnh nhỏ hơn dung sai. Dung sai mặc định là 10^-9 độ.

Phương thức tĩnh

containsLocation

containsLocation(point, polygon)

Thông số:

point: LatLng|LatLngLiteral
polygon: Polygon

Giá trị trả về: boolean

Tính toán xem điểm đã cho có nằm bên trong đa giác đã chỉ định hay không.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Thông số:

point: LatLng|LatLngLiteral
poly: Polygon|Polyline
tolerance: number optional

Giá trị trả về: boolean

Tính toán xem điểm đã cho có nằm trên hoặc gần một đường đa tuyến hay cạnh của đa giác hay không, trong một dung sai đã chỉ định. Trả về true khi chênh lệch giữa vĩ độ và kinh độ của điểm được cung cấp và điểm gần nhất trên cạnh nhỏ hơn dung sai. Dung sai mặc định là 10^-9 độ.