Erweiterte GeoJSON-Geometrien

Artikel
04/19/2023

Azure Maps stellt eine Liste leistungsstarker APIs zum Suchen in und entlang geografischer Merkmale bereit. Diese APIs entsprechen den standardmäßigen GeoJSON-Spezifikationen, die geografische Features darstellen.

Die GeoJSON-Spezifikation unterstützt nur die folgenden Geometrien:

GeometryCollection
LineString
MultiLineString
MultiPoint
MultiPolygon
Point
Polygon

Einige Azure Maps-APIs akzeptieren Geometrien, die nicht Teil der GeoJSON-Spezifikation sind. Beispielsweise akzeptiert die Suche in Geometrie-API Kreis und Polygone.

In diesem Artikel wird ausführlich beschrieben, wie Azure Maps die GeoJSON-Spezifikation erweitert, um bestimmte Geometrien darzustellen.

Circle

Die GeoJSON-Spezifikation unterstützt die Circle-Geometrie nicht. Das GeoJSON Point Feature-Objekt wird verwendet, um einen Kreis darzustellen.

Eine Circle-Geometrie, die mithilfe des GeoJSON Feature-Objekts dargestellt wird, muss folgende Koordinaten und Eigenschaften enthalten:

Koordinaten	Eigenschaft
Zentrum	Das Zentrum des Kreises wird mit einem `GeoJSON Point`-Objekt dargestellt.
Radius	Der `radius` des Kreises wird mithilfe der Eigenschaften von `GeoJSON Feature` dargestellt. Der Radiuswert wird in Metern dargestellt und muss vom Typ `double` sein.
SubType	Die Geometrie des Kreises muss ebenso die `subType`-Eigenschaft enthalten. Diese Eigenschaft muss Teil der Eigenschaften von `GeoJSON Feature` sein, und der Wert sollte Circle lauten.

Kreisbeispiel

So stellen Sie einen Kreis mit einem GeoJSON Feature-Objekt dar. Zentrieren Sie den Kreis auf dem Breitengrad: 47,639754 und Längengrad: -122,126986, und weisen Sie einen Radius von 100 Metern zu:

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

Rechteck

Die GeoJSON-Spezifikation unterstützt die Rectangle-Geometrie nicht. Das GeoJSON Polygon Feature-Objekt wird verwendet, um ein Rechteck darzustellen. Die Rechteckerweiterung wird hauptsächlich vom Zeichentoolmodul des Web SDK genutzt.

Eine Rectangle-Geometrie, die mithilfe des GeoJSON Polygon Feature-Objekts dargestellt wird, muss folgende Koordinaten und Eigenschaften enthalten:

Koordinaten	Eigenschaft
Ecken	Die Ecken des Rechtecks werden mit den Koordinaten eines `GeoJSON Polygon`-Objekts dargestellt. Es sollten fünf Koordinaten vorhanden sein, eine für jede Ecke. Eine fünfte Koordinate, die mit der ersten Koordinate identisch ist, schließt den Polygonring. Es wird davon ausgegangen, dass diese Koordinaten ausgerichtet sind und der Entwickler sie wie gewünscht drehen kann.
SubType	Die Geometrie des Rechtecks muss auch die `subType`-Eigenschaft enthalten. Diese Eigenschaft muss ein Teil der Eigenschaften von `GeoJSON Feature` sein, und der Wert sollte Rectangle lauten.

Rechteckbeispiel

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

Nächste Schritte

Weitere Informationen zu GeoJSON-Daten in Azure Maps:

GeoJSON-Format des Geofence

Sehen Sie sich das Glossar mit den häufigen technischen Ausdrücken an, die Azure Maps und Location Intelligence-Anwendungen zugeordnet sind:

Azure Maps-Glossar

Freigeben über