Thông báo bảo mật: Chúng tôi đã nhận thấy một vấn đề bảo mật có thể ảnh hưởng đến các trang web sử dụng các thư viện cụ thể của bên thứ ba (bao gồm cả polyfill.io). Vấn đề này đôi khi có thể chuyển hướng khách truy cập khỏi trang web mong muốn mà chủ sở hữu trang web không biết hoặc không cho phép. Nhiều mẫu JavaScript của chúng tôi trước đây đã bao gồm phần khai báo tập lệnh polyfill.io. Chúng tôi đã xoá phương thức này khỏi các mẫu của mình. Nếu đã sử dụng các mẫu JavaScript có chứa nội dung khai báo này, bạn nên xoá nội dung khai báo.

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

Geometry Library

mã hoá không gian tên

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

Tiện ích để mã hoá và giải mã nhiều dòng.

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

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

Không gian tên hình cầu

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 trắc địa. Bán kính mặc định là bán kính của Trái đất là 6378137 mét.

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

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

Không gian tên poly

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

Hàm hiệu dụng để tính toán liên quan đến đa giác và hình nhiều đường.

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

Phương thức tĩnh
`containsLocation`	`containsLocation(point, polygon)` Các thông số: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Giá trị trả về: `boolean` Tính toán xem điểm đã cho có nằm trong đa giác đã chỉ định hay không.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Các 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 nằm trên hay gần một hình nhiều đường hoặc cạnh của đa giác, trong phạm vi dung sai đã chỉ định. Trả về `true` khi chênh lệch giữa vĩ độ và kinh độ của điểm đã 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)

Các thông số:

point: LatLng|LatLngLiteral
polygon: Polygon

Giá trị trả về: boolean

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

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Các 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 nằm trên hay gần một hình nhiều đường hoặc cạnh của đa giác, trong phạm vi dung sai đã chỉ định. Trả về true khi chênh lệch giữa vĩ độ và kinh độ của điểm đã 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 độ.