Geometrias GeoJSON estendidas

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.
Raio	O círculo radius é representado usando GeoJSON Featureas 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 Featurepropriedades 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 Featurepropriedades 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