Utökade GeoJSON-geometrier

Azure Maps innehåller en lista över kraftfulla API:er för sökning i och längs geografiska funktioner. Dessa API:er följer geoJSON-standardspecifikationen för att representera geografiska funktioner.

GeoJSON-specifikationen stöder endast följande geometrier:

• GeometryCollection
• LineString
• MultiLineString
• MultiPoint
• MultiPolygon
• Punkt
• Polygon

Vissa Azure Maps-API:er accepterar geometrier som inte ingår i GeoJSON-specifikationen. Till exempel accepterar API:et Search Inside Geometry Circle och Polygons.

Den här artikeln innehåller en detaljerad förklaring av hur Azure Maps utökar GeoJSON-specifikationen så att den representerar vissa geometrier.

Cirkel

GeoJSON-specifikationen Circle stöder inte geometrin. Objektet GeoJSON Point Feature används för att representera en cirkel.

En Circle geometri som representeras med hjälp av GeoJSON Feature objektet måste innehålla följande koordinater och egenskaper:

Koordinat	Property
Mitten	Cirkelns mittpunkt representeras med hjälp av ett GeoJSON Point objekt.
Radius	Cirkelns representeras radius med hjälp av GeoJSON Featureegenskaper. Radievärdet är i meter och måste vara av typen double.
SubType	Cirkelgeometrin måste också innehålla subType egenskapen. Den här egenskapen måste vara en del av GeoJSON Featureegenskaperna och dess värde ska vara Circle

Cirkelexempel

Så här representerar du en cirkel med hjälp av ett GeoJSON Feature objekt. Nu ska vi centrera cirkeln på latitud: 47.639754 och longitud: -122.126986 och tilldela den en radie som är lika med 100 meter:

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

Rektangel

GeoJSON-specifikationen Rectangle stöder inte geometrin. Objektet GeoJSON Polygon Feature används för att representera en rektangel. Rektangelns tillägg används främst av Web SDK:s ritverktygsmodul.

En Rectangle geometri som representeras med hjälp av GeoJSON Polygon Feature objektet måste innehålla följande koordinater och egenskaper:

Koordinat	Property
Hörn	Rektangelns hörn representeras med hjälp av koordinaterna för ett GeoJSON Polygon objekt. Det bör finnas fem koordinater, en för varje hörn. Och en femte koordinat som är samma som den första koordinaten, för att stänga polygonringen. Det förutsätts att koordinaterna justeras och att utvecklaren kan rotera dem efter behov.
SubType	Rektangelns geometri måste också innehålla subType egenskapen. Den här egenskapen måste vara en del av GeoJSON Featureegenskaperna och dess värde ska vara rektangel.

Rektangelexempel

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

Nästa steg

Läs mer om GeoJSON-data i Azure Maps:

Geofence GeoJSON-format

Läs ordlistan med vanliga tekniska termer som är associerade med Azure Maps och platsinformationsprogram:

Ordlista för Azure Maps