Uitgebreide GeoJSON-geometrieën

Artikel
08/02/2024

Azure Maps biedt een lijst met krachtige API's om binnen en langs geografische functies te zoeken. Deze API's voldoen aan de standaardspecificatie van GeoJSON voor het weergeven van geografische kenmerken.

De GeoJSON-specificatie ondersteunt alleen de volgende geometrieën:

GeometryCollection
LineString
MultiLineString
MultiPoint
MultiPolygon
Contact
Polygoon

Sommige Azure Maps-API's accepteren geometrieën die geen deel uitmaken van de GeoJSON-specificatie. De Search Inside Geometry-API accepteert bijvoorbeeld Cirkel en Veelhoeken.

Dit artikel bevat een gedetailleerde uitleg over hoe Azure Maps de GeoJSON-specificatie uitbreidt om bepaalde geometrieën weer te geven.

Cirkel

De GeoJSON-specificatie biedt geen ondersteuning voor de Circle geometrie. Het GeoJSON Point Feature object wordt gebruikt om een cirkel weer te geven.

Een Circle geometrie die met behulp van het GeoJSON Feature object wordt weergegeven, moet de volgende coördinaten en eigenschappen bevatten:

Coördineren	Eigenschappen
Centreren	Het midden van de cirkel wordt weergegeven met behulp van een `GeoJSON Point` object.
Radius	De cirkels worden weergegeven met behulp van `GeoJSON Feature`de eigenschappen van de cirkel`radius`. De radiuswaarde is in meters en moet van het type `double`zijn.
Subtype	De cirkelgeometrie moet ook de `subType` eigenschap bevatten. Deze eigenschap moet deel uitmaken van de eigenschappen van de `GeoJSON Feature`eigenschap en de waarde moet Cirkel zijn

Cirkelvoorbeeld

Hier ziet u hoe u een cirkel vertegenwoordigt met behulp van een GeoJSON Feature object. Laten we de cirkel centreren op breedtegraad: 47.639754 en lengtegraad: -122.126986 en deze een straal toewijzen die gelijk is aan 100 meter:

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

Rechthoek

De GeoJSON-specificatie biedt geen ondersteuning voor de Rectangle geometrie. Het GeoJSON Polygon Feature object wordt gebruikt om een rechthoek weer te geven. De rechthoekextensie wordt voornamelijk gebruikt door de module tekenhulpmiddelen van de Web SDK.

Een Rectangle geometrie die met behulp van het GeoJSON Polygon Feature object wordt weergegeven, moet de volgende coördinaten en eigenschappen bevatten:

Coördineren	Eigenschappen
Hoeken	De hoeken van de rechthoek worden weergegeven met behulp van de coördinaten van een `GeoJSON Polygon` object. Er moeten vijf coördinaten zijn, één voor elke hoek. En een vijfde coördinaat die hetzelfde is als de eerste coördinaat, om de veelhoekring te sluiten. Er wordt van uitgegaan dat deze coördinaten zijn uitgelijnd en dat de ontwikkelaar deze naar wens kan draaien.
Subtype	De geometrie van de rechthoek moet ook de `subType` eigenschap bevatten. Deze eigenschap moet deel uitmaken van de eigenschappen van de `GeoJSON Feature`eigenschap en de waarde moet rechthoek zijn.

Voorbeeld van rechthoek

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

Volgende stappen

Meer informatie over GeoJSON-gegevens in Azure Maps:

Geofence GeoJSON-indeling

Bekijk de woordenlijst met algemene technische termen die zijn gekoppeld aan Azure Maps en location intelligence-toepassingen:

Azure Maps-woordenlijst

Delen via