Geometri GeoJSON yang diperluas

Artikel
04/14/2023

Azure Maps menyediakan daftar API yang kuat untuk mencari di dalam dan di sepanjang fitur geografis. API tersebut mematuhi spesifikasi GeoJSON standar yang mewakili fitur geografis.

Spesifikasi GeoJSON hanya mendukung geometri berikut:

GeometryCollection
LineString
MultiLineString
MultiPoint
MultiPolygon
Titik
Poligon

Beberapa API Azure Maps menerima geometri yang bukan bagian dari spesifikasi GeoJSON. Misalnya, Search Inside Geometry API menerima Lingkaran dan Poligon.

Artikel ini memberikan penjelasan terperinci tentang cara Azure Maps memperluas spesifikasi GeoJSON untuk mewakili geometri tertentu.

Lingkaran

Spesifikasi GeoJSON tidak mendukung Circle geometri. Objek GeoJSON Point Feature digunakan untuk mewakili lingkaran.

Geometri Circle yang diwakili menggunakan objek GeoJSON Featureharus berisi koordinat dan properti berikut:

Koordinat	Properti
Pusat	Pusat lingkaran diwakili menggunakan objek `GeoJSON Point`.
Radius	`radius` lingkaran diwakili menggunakan properti `GeoJSON Feature`. Nilai radius dalam meter dan harus dari jenis `double`.
SubType	Geometri lingkaran juga harus berisi properti `subType`. Properti ini harus menjadi bagian dari properti `GeoJSON Feature` dan nilainya harus Circle

Contoh lingkaran

Berikut adalah cara Anda mewakili lingkaran menggunakan GeoJSON Feature objek. Mari pusatkan lingkaran pada garis lintang: 47.639754 dan garis bujur: -122.126986, dan tentukan radius yang sama dengan 100 meter:

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "subType": "Circle",
        "radius": 100
    }
}

Persegi

Spesifikasi GeoJSON tidak mendukung Rectangle geometri. Objek GeoJSON Polygon Feature digunakan untuk mewakili persegi panjang. Ekstensi persegi terutama digunakan oleh modul alat gambar Web SDK.

Geometri Rectangle yang diwakili menggunakan objek GeoJSON Polygon Featureharus berisi koordinat dan properti berikut:

Koordinat	Properti
Sudut	Sudut persegi diwakili menggunakan koordinat objek `GeoJSON Polygon`. Harus ada lima koordinat, satu untuk setiap sudut. Dan, koordinat kelima yang sama dengan koordinat pertama, untuk menutup cincin poligon. Diasumsikan bahwa koordinat ini selaras, dan pengembang dapat memutarnya sesuai keinginan.
SubType	Geometri persegi juga harus berisi properti `subType`. Properti ini harus menjadi bagian `GeoJSON Feature`dari properti , dan nilainya harus Persegi Panjang.

Contoh persegi panjang

{
    "type": "Feature",
    "geometry": {
        "type": "Polygon",
        "coordinates": [[[5,25],[14,25],[14,29],[5,29],[5,25]]]
    },
    "properties": {
        "subType": "Rectangle"
    }
}

Langkah berikutnya

Pelajari selengkapnya tentang data GeoJSON di Azure Maps:

Format Geofence GeoJSON

Ulas glosarium istilah teknis umum yang terkait dengan Azure Maps dan aplikasi kecerdasan lokasi:

Glosarium Azure Maps

Share via