Géométries GeoJSON étendues

Azure Maps fournit une liste de puissantes API permettant de rechercher à l’intérieur et le long des caractéristiques géographiques. Ces API adhèrent à la spécification GeoJSON standard de la représentation des caractéristiques géographiques.

La spécification GeoJSON ne prend en charge que les géométries suivantes :

• GeometryCollection
• LineString
• MultiLineString
• MultiPoint
• MultiPolygon
• Point
• Polygone

Certaines API Azure Maps acceptent des géométries qui ne font pas partie de la spécification GeoJSON. Par exemple, l’API Search Inside Geometry accepte des cercles et des polygones.

Cet article fournit une explication détaillée sur la façon dont Azure Maps étend la spécification GeoJSON pour représenter certaines géométries.

Circle

La spécification GeoJSON ne prend pas en charge la géométrie Circle. L’objet GeoJSON Point Feature est utilisé pour représenter un cercle.

Une géométrie Circle représentée à l’aide de l’objet GeoJSON Featuredoit contenir les coordonnées et les propriétés suivantes :

Coordonnée	Propriété
Center	Le centre du cercle est représenté par un objet GeoJSON Point.
Radius	Le radius du cercle est représenté à l’aide des propriétés de GeoJSON Feature. La valeur du rayon est exprimée en mètres et doit être du type double.
Subtype	La géométrie circle doit également contenir la propriété subType. Cette propriété doit faire partie des propriétés de la GeoJSON Feature, et sa valeur doit être Circle.

Exemple de cercle

Voici comment vous représentez un cercle à l’aide d’un objet GeoJSON Feature. Nous allons centrer le cercle à la latitude : 47,639754 et à la longitude :-122,126986, et lui attribuez un rayon égal à 100 mètres :

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

Rectangle

La spécification GeoJSON ne prend pas en charge la géométrie Rectangle. L’objet GeoJSON Polygon Feature est utilisé pour représenter un rectangle. L’extension de rectangle est principalement utilisée par le module des outils de dessin du SDK web.

Une géométrie Rectangle représentée à l’aide de l’objet GeoJSON Polygon Featuredoit contenir les coordonnées et les propriétés suivantes :

Coordonnée	Propriété
Angles	Les angles du rectangle sont représentés à l’aide des coordonnées d’un objet GeoJSON Polygon. Il doit y avoir cinq coordonnées, une pour chaque sommet et une cinquième identique à la première coordonnée pour fermer l’anneau polygonal. Il est supposé que ces coordonnées s’alignent et que le développeur peut les faire pivoter comme il le souhaite.
Subtype	La géométrie rectangle doit également contenir la propriété subType. Cette propriété doit faire partie des propriétés de GeoJSON Feature, et sa valeur doit être Rectangle.

Exemple de rectangle

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

Étapes suivantes

En savoir plus sur les données GeoJSON dans Azure Maps :

Format GeoJSON de limite géographique

Consultez le glossaire des termes techniques courants associés à Azure Maps et aux applications de géolocalisation :

Glossaire Azure Maps