Geometry Library

không gian tên mã hoá

google.maps.geometry.encoding không gian tên
thư viện "geometry"

Tiện ích để mã hoá và giải mã hình nhiều đường.

const {encoding} = await google.maps.importLibrary("geometry");

Phương thức tĩnh
decodePath	decodePath(encodedPath) Tham 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) Tham 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 spherical

google.maps.geometry.spherical không gian tên
thư viện "geometry"

Các hàm hiệu dụng để 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, tức là 6.378.137 mét.

const {spherical} = await google.maps.importLibrary("geometry");

Phương thức tĩnh
computeArea	computeArea(path[, radiusOfSphere]) Tham 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 không dấu của một đường dẫn khép kín, trong phạm vi [0, 2×pi×radius²]. 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 của Trái Đất tính bằng mét, trong trường hợp đó, diện tích được 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 xa hơn về phía bắc so với LatLng phía bắc.
computeDistanceBetween	computeDistanceBetween(from, to[, radius]) Tham 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 tuỳ chỉnh (không bắt buộc). Bán kính mặc định là bán kính của Trái Đất.
computeHeading	computeHeading(from, to) Tham 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ừ hướng Bắc trong phạm vi [-180,180).
computeLength	computeLength(path[, radius]) Tham 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]) Tham 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 (được biểu thị bằng độ theo chiều kim đồng hồ từ hướng bắc).
computeOffsetOrigin	computeOffsetOrigin(to, distance, heading[, radius]) Tham số: to: LatLng|LatLngLiteral distance: number heading: number radius: number optional Giá trị trả về: LatLng|null Trả về vị trí xuất phát khi được cung cấp điểm đến LatLng, số mét đã di chuyển 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ó nghiệm.
computeSignedArea	computeSignedArea(loop[, radius]) Tham số: loop: Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> radius: number optional Giá trị trả về: number Trả về diện tích có dấu của một đường dẫn khép kín, trong đó ngược chiều kim đồng hồ là dương, trong phạm vi [-2×pi×radius², 2×pi×radius²]. 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 của Trái Đất tính bằng mét, trong trường hợp đó, 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 vận chuyển song song; vận chuyển song song xung quanh một đường dẫn khép 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 quanh bởi đường dẫn. Phương pháp này đơn giản, chính xác và hiệu quả hơn so với phương pháp tam giác đạc sử dụng Girard, l'Huilier hoặc Eriksson trên mỗi tam giác. Cụ thể, vì không phân chia thành tam giác nên thuật toán này không gặp phải tình trạng 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) Tham số: from: LatLng|LatLngLiteral to: LatLng|LatLngLiteral fraction: number Giá trị trả về: LatLng Trả về LatLng nằm ở phần đã cho của đường đi giữa LatLng gốc và LatLng đích.
traversePath	Lưu ý: Chỉ có trong kênh v=alpha. traversePath(path, fraction) Tham số: path: Array<LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral> fraction: number Giá trị trả về: LatLngLiteral Trả về vị trí nằm ở phân số đã cho của đường đi dọc theo đường dẫn đã cho. Nếu truyền đối tượng LatLngAltitude, thì độ cao hiện sẽ bị bỏ qua, nhưng các phiên bản trong tương lai có thể tính đến độ cao.

không gian tên poly

google.maps.geometry.poly không gian tên
thư viện "geometry"

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

const {poly} = await google.maps.importLibrary("geometry");

Phương thức tĩnh
containsLocation	containsLocation(point, polygon) Tham 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 được chỉ định hay không.
isLocationOnEdge	isLocationOnEdge(point, poly[, tolerance]) Tham 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 một đa giác hay không, trong phạm vi dung sai đã chỉ định. Trả về true khi mức 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 độ.