Rozszerzone geometrie GeoJSON

Usługa Azure Maps udostępnia listę zaawansowanych interfejsów API do wyszukiwania wewnątrz i wzdłuż funkcji geograficznych. Te interfejsy API są zgodne ze standardową specyfikacją geoJSON reprezentującą funkcje geograficzne.

Specyfikacja GeoJSON obsługuje tylko następujące geometrie:

• GeometryCollection
• LineString
• MultiLineString
• MultiPoint
• MultiPolygon
• Osoba
• Wielokąt

Niektóre interfejsy API usługi Azure Maps akceptują geometrie, które nie są częścią specyfikacji GeoJSON. Na przykład interfejs API wyszukiwania wewnątrz geometrii akceptuje okręgi i wielokąty.

Ten artykuł zawiera szczegółowe wyjaśnienie, w jaki sposób usługa Azure Maps rozszerza specyfikację GeoJSON w celu reprezentowania niektórych geometrii.

Okrąg

Specyfikacja GeoJSON nie obsługuje Circle geometrii. Obiekt GeoJSON Point Feature jest używany do reprezentowania okręgu.

Geometria Circle reprezentowana przy użyciu GeoJSON Feature obiektu musi zawierać następujące współrzędne i właściwości:

Koordynować	Właściwości
Wyśrodkuj	Środek okręgu jest reprezentowany przy użyciu GeoJSON Point obiektu.
Radius	Okręg radius jest reprezentowany przy użyciu GeoJSON Featurewłaściwości . Wartość promienia jest wyrażona w metrach i musi być typu double.
Podtyp	Geometria okręgu subType musi również zawierać właściwość . Ta właściwość musi być częścią GeoJSON Featurewłaściwości właściwości , a jej wartość powinna mieć wartość Circle

Przykład okręgu

Poniżej przedstawiono sposób reprezentowania okręgu GeoJSON Feature przy użyciu obiektu. Wyśrodkujmy okrąg na szerokości geograficznej: 47,639754 i długość geograficzna: -122,126986 i przypisz do niego promień równy 100 metrów:

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

Prostokąt

Specyfikacja GeoJSON nie obsługuje Rectangle geometrii. Obiekt GeoJSON Polygon Feature jest używany do reprezentowania prostokąta. Rozszerzenie prostokąta jest używane głównie przez moduł narzędzi do rysowania zestawu WEB SDK.

Geometria Rectangle reprezentowana przy użyciu GeoJSON Polygon Feature obiektu musi zawierać następujące współrzędne i właściwości:

Koordynować	Właściwości
Narożniki	Narożniki prostokąta są reprezentowane przy użyciu współrzędnych GeoJSON Polygon obiektu. Dla każdego rogu powinno znajdować się pięć współrzędnych. I piąta współrzędna, która jest taka sama jak pierwsza współrzędna, aby zamknąć pierścień wielokątny. Zakłada się, że te współrzędne są wyrównane i że deweloper może je obracać zgodnie z potrzebami.
Podtyp	Geometria prostokąta subType musi również zawierać właściwość . Ta właściwość musi być częścią GeoJSON Featurewłaściwości ,a jej wartość powinna być prostokątna.

Przykład prostokąta

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

Następne kroki

Dowiedz się więcej o danych GeoJSON w usłudze Azure Maps:

Format GeoJSON geofencingu

Zapoznaj się ze słownikiem typowych terminów technicznych skojarzonych z usługą Azure Maps i aplikacjami analizy lokalizacji:

Słownik usługi Azure Maps