Share via


Geometrie GeoJSON estese

Mappe di Azure fornisce un elenco di API potenti da cercare all'interno e lungo le funzionalità geografiche. Queste API rispettano la specifica GeoJSON standard di che rappresenta le funzionalità geografiche.

La specifica GeoJSON supporta solo le geometrie seguenti:

  • GeometryCollection
  • LineString
  • MultiLineString
  • MultiPoint
  • MultiPolygon
  • Point
  • Polygon

Alcune API Mappe di Azure accettano geometrie che non fanno parte della specifica GeoJSON. Ad esempio, l'API Cerca all'interno della geometria accetta cerchi e poligoni.

Questo articolo illustra in dettaglio come Mappe di Azure estende la specifica GeoJSON per rappresentare determinate geometrie.

Cerchio vuoto

La specifica GeoJSON non supporta la Circle geometria. L'oggetto GeoJSON Point Feature viene utilizzato per rappresentare un cerchio.

Una Circle geometria rappresentata tramite l'oggetto GeoJSON Featuredeve contenere le coordinate e le proprietà seguenti:

Coordinate Proprietà
Center Il centro del cerchio viene rappresentato utilizzando un GeoJSON Point oggetto .
Radius L'elemento radius del cerchio viene rappresentato usando le proprietà di GeoJSON Feature. Il valore del raggio è espresso in metri e deve essere di tipo double.
Sottotipo La geometria circle deve contenere anche la proprietà subType. Questa proprietà deve far parte delle proprietà dell'oggetto GeoJSON Featuree il relativo valore deve essere Circle

Esempio circle

Ecco come rappresentare un cerchio usando un GeoJSON Feature oggetto . Centrare il cerchio alla latitudine: 47.639754 e longitudine: -122.126986 e assegnargli un raggio uguale a 100 metri:

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

Rettangolo

La specifica GeoJSON non supporta la Rectangle geometria. L'oggetto GeoJSON Polygon Feature viene utilizzato per rappresentare un rettangolo. L'estensione del rettangolo viene usata principalmente dal modulo strumenti di disegno di Web SDK.

Una Rectangle geometria rappresentata tramite l'oggetto GeoJSON Polygon Featuredeve contenere le coordinate e le proprietà seguenti:

Coordinate Proprietà
Angoli Gli angoli del rettangolo vengono rappresentati utilizzando le coordinate di un GeoJSON Polygon oggetto . Dovrebbero essere presenti cinque coordinate, una per ogni angolo. E, una quinta coordinata uguale alla prima coordinata, per chiudere l'anello poligono. Si presuppone che queste coordinate siano allineate e che lo sviluppatore possa ruotarle nel modo desiderato.
Sottotipo La geometria del rettangolo deve contenere anche la subType proprietà . Questa proprietà deve far parte delle GeoJSON Featureproprietà e il relativo valore deve essere Rectangle.

Esempio di rettangolo

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

Passaggi successivi

Altre informazioni sui dati GeoJSON in Mappe di Azure:

Esaminare il glossario dei termini tecnici comuni associati alle applicazioni di Mappe di Azure e location intelligence: