Geometrias GeoJSON estendidas

Artigo
01/15/2024

O Azure Maps fornece uma lista de APIs poderosas para pesquisar dentro e ao longo de recursos geográficos. Essas APIs aderem à especificação padrão GeoJSON de representação de características geográficas.

A especificação GeoJSON suporta apenas as seguintes geometrias:

GeometryCollection
LineString
MultiLineString
MultiPonto
Multipolígono
Ponto
Polígono

Algumas APIs do Azure Maps aceitam geometrias que não fazem parte da especificação GeoJSON. Por exemplo, a API Search Inside Geometry aceita Circle e Polygons.

Este artigo fornece uma explicação detalhada sobre como o Azure Maps estende a especificação GeoJSON para representar determinadas geometrias.

Círculo

A especificação GeoJSON não suporta a Circle geometria. O GeoJSON Point Feature objeto é usado para representar um círculo.

Uma Circle geometria representada usando o GeoJSON Feature objeto deve conter as seguintes coordenadas e propriedades:

Coordenar	Property
Center	O centro do círculo é representado usando um `GeoJSON Point` objeto.
Radius	O círculo `radius` é representado usando `GeoJSON Feature`as propriedades de . O valor do raio é em metros e deve ser do tipo `double`.
Subtipo	A geometria do círculo também deve conter a `subType` propriedade. Essa propriedade deve fazer parte das `GeoJSON Feature`propriedades do e seu valor deve ser Circle

Exemplo de círculo

Veja como você representa um círculo usando um GeoJSON Feature objeto. Vamos centralizar o círculo na latitude: 47,639754 e longitude: -122,126986, e atribuir-lhe um raio igual a 100 metros:

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

Retângulo

A especificação GeoJSON não suporta a Rectangle geometria. O GeoJSON Polygon Feature objeto é usado para representar um retângulo. A extensão do retângulo é usada principalmente pelo módulo de ferramentas de desenho do Web SDK.

Uma Rectangle geometria representada usando o GeoJSON Polygon Feature objeto deve conter as seguintes coordenadas e propriedades:

Coordenar	Property
Cantos	Os cantos do retângulo são representados usando as coordenadas de um `GeoJSON Polygon` objeto. Deve haver cinco coordenadas, uma para cada canto. E, uma quinta coordenada que é a mesma que a primeira coordenada, para fechar o anel do polígono. Supõe-se que essas coordenadas estejam alinhadas e que o desenvolvedor possa girá-las conforme desejado.
Subtipo	A geometria do retângulo também deve conter a `subType` propriedade. Esta propriedade deve fazer parte das `GeoJSON Feature`propriedades do , e seu valor deve ser Rectangle.

Exemplo de retângulo

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

Próximos passos

Saiba mais sobre os dados GeoJSON no Azure Maps:

Formato GeoJSON Geofence

Reveja o glossário de termos técnicos comuns associados ao Azure Maps e às aplicações de inteligência de localização:

Glossário do Azure Maps

Partilhar via