Teilen über

Erweiterte GeoJSON-Geometrien

  • Artikel

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