Geometry Library

namespace encoding

namespace google.maps.geometry.encoding
library "geometry"

Utilitas untuk encoding dan decoding polyline.

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
Parameter:
  • encodedPath: string
Nilai Hasil: Array<LatLng>
Mendekode string jalur yang dienkode menjadi urutan LatLng.
encodePath
encodePath(path)
Parameter:
Nilai Hasil: string
Mengenkode urutan LatLng menjadi string jalur yang dienkode.

namespace spherical

namespace google.maps.geometry.spherical
library "geometry"

Fungsi utilitas untuk menghitung sudut, jarak, dan luas geodesi. Radius default-nya adalah radius Bumi, yaitu 6.378.137 meter.

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
Parameter:
Nilai Hasil: number
Menampilkan area tanpa tanda dari jalur tertutup, dalam rentang [0, 2×pi×radius²]. Area yang dihitung menggunakan satuan yang sama dengan radius. radiusOfSphere ditetapkan secara default ke radius Bumi dalam meter, sehingga luasnya dalam meter persegi. Meneruskan Circle mengharuskan radius ditetapkan ke nilai non-negatif. Selain itu, Lingkaran tidak boleh mencakup lebih dari 100% bola. Dan saat meneruskan LatLngBounds, LatLng selatan tidak boleh lebih ke utara daripada LatLng utara.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parameter:
Nilai Hasil: number
Menampilkan jarak, dalam meter, antara dua LatLng. Anda dapat menentukan radius kustom secara opsional. Radius default-nya adalah radius Bumi.
computeHeading
computeHeading(from, to)
Parameter:
Nilai Hasil: number
Menampilkan arah dari satu LatLng ke LatLng lainnya. Arah dinyatakan dalam derajat searah jarum jam dari Utara dalam rentang [-180,180).
computeLength
computeLength(path[, radius])
Parameter:
Nilai Hasil: number
Menampilkan panjang jalur yang diberikan.
computeOffset
computeOffset(from, distance, heading[, radius])
Parameter:
Nilai Hasil: LatLng
Menampilkan LatLng yang dihasilkan dari perpindahan jarak dari asal di arah yang ditentukan (dinyatakan dalam derajat searah jarum jam dari utara).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Parameter:
Nilai Hasil: LatLng|null
Menampilkan lokasi asal jika diberikan tujuan LatLng, meter yang ditempuh, dan arah awal. Arah dinyatakan dalam derajat searah jarum jam dari Utara. Fungsi ini menampilkan null jika tidak ada solusi yang tersedia.
computeSignedArea
computeSignedArea(loop[, radius])
Parameter:
Nilai Hasil: number
Menampilkan area bertanda dari jalur tertutup, dengan arah berlawanan jarum jam bernilai positif, dalam rentang [-2×pi×radius², 2×pi×radius²]. Area yang dihitung menggunakan satuan yang sama dengan radius. Radius ditetapkan secara default ke radius Bumi dalam meter, sehingga luasnya dalam meter persegi.

Luas dihitung menggunakan metode transportasi paralel; transportasi paralel di sekitar jalur tertutup pada bola satuan berputar dengan sudut yang sama dengan luas yang dilingkupi oleh jalur tersebut. Metode ini lebih sederhana, akurat, dan andal daripada triangulasi menggunakan Girard, l'Huilier, atau Eriksson pada setiap segitiga. Secara khusus, karena tidak melakukan triangulasi, poligon ini tidak mengalami ketidakstabilan kecuali dalam kasus yang tidak dapat dihindari saat tepi (bukan diagonal) poligon membentang 180 derajat.
interpolate
interpolate(from, to, fraction)
Parameter:
Nilai Hasil: LatLng
Menampilkan LatLng yang terletak pada pecahan jarak yang diberikan di antara LatLng asal dan LatLng tujuan.
AlphatraversePath
traversePath(path, fraction)
Parameter:
Nilai Hasil: LatLngLiteral
Menampilkan posisi yang terletak pada pecahan jarak yang diberikan di sepanjang jalur yang diberikan. Jika meneruskan objek LatLngAltitude, ketinggian saat ini diabaikan, tetapi versi mendatang mungkin akan memperhitungkan ketinggian.

Namespace poly

namespace google.maps.geometry.poly
library "geometry"

Fungsi utilitas untuk komputasi yang melibatkan poligon dan polyline.

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
Parameter:
Nilai Hasil: boolean
Menghitung apakah titik yang diberikan berada di dalam poligon atau lingkaran yang ditentukan. Meneruskan Circle mengharuskan center ditetapkan dan radius ditetapkan ke nilai non-negatif.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parameter:
Nilai Hasil: boolean
Menghitung apakah titik tertentu berada pada atau di dekat polyline, atau tepi poligon, dalam toleransi yang ditentukan. Menampilkan true jika perbedaan antara lintang dan bujur titik yang diberikan, dan titik terdekat di tepi, kurang dari toleransi. Toleransi ditetapkan secara default ke 10-9 derajat.