Geometry Library

Lớp mã hoá

Lớp google.maps.geometry.encoding

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

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

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 được 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á.

Lớp spherical

Lớp google.maps.geometry.spherical

Hàm tiện ích để tính toán các 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.

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

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 có dấu của một đường khép kín, trong phạm vi [0, 2×pi×radius²]. Diện tích được tính bằ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 này, diện tích được tính bằng mét vuông. Việc truyền Circle yêu cầu bạn đặt radius thành một giá trị không âm. Ngoài ra, Vòng kết nối không được bao phủ quá 100% quả cầu. Khi truyền một LatLngBounds, LatLng phía nam không được ở phía bắc hơn 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ể 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) Tham số:  from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral Giá trị trả về:  number Trả về hướng đi 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ừ vị trí ban đầu 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í ban đầu khi được cung cấp đích đến LatLng, số mét đã đi và hướng ban đầu. Hướng đi đượ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]) 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 khép kín, trong đó chiều 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 bằ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 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 vận chuyển song song; vận chuyển song song xung quanh một đường khép kín trên hình cầu đơn vị sẽ xoắn theo một góc bằng với diện tích được bao quanh bởi đường đó. Cách này đơn giản, chính xác và mạnh mẽ hơn so với phương pháp đo đạc tam giác bằng cách sử dụng Girard, l'Huilier hoặc Eriksson trên mỗi tam giác. Cụ thể, vì không có hình tam giác nên hình này không bị mất ổ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 ở một phần nhất định giữa LatLng gốc và LatLng đích.

Lớp poly

Lớp google.maps.geometry.poly

Hàm tiện ích để tính toán liên quan đến đa giác và đường nhiều đoạn.

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

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 đã 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 đường nhiều đường, hay cạnh của một đa giác, trong phạm vi dung sai đã chỉ định hay không. 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. Sai số mặc định là 10^-9 độ.