Geometrias GeoJSON estendidas

Artigo
04/17/2023

O Azure Mapas fornece uma lista de APIs avançada para pesquisa dentro e ao longo de características geográficas. Essas APIs aderem à especificação GeoJSON padrão de representar características geográficas.

A especificação GeoJSON dá suporte apenas às seguintes geometrias:

GeometryCollection
LineString
MultiLineString
MultiPoint
MultiPolygon
Point
Polygon

Algumas APIs do Azure Mapas aceitam geometrias que não fazem parte da especificação GeoJSON. Por exemplo, a API Pesquisar Dentro da Geometria aceita círculos e polígonos.

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

Circle

A especificação GeoJSON não dá suporte à Circle geometria. O objeto GeoJSON Point Feature é usado para representar um círculo.

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

Coordenada	Propriedade
Centro	O centro do círculo é representado usando um objeto `GeoJSON Point`.
Raio	O círculo `radius` é representada usando as propriedades de `GeoJSON Feature`. O valor de raio está em metros e deve ser do tipo `double`.
SubType	A geometria do círculo também deve conter a propriedade `subType`. Essa propriedade deve ser uma parte das propriedades `GeoJSON Feature` e seu valor deve ser Circle

Exemplo de círculo

Veja como você representa um círculo usando um objeto GeoJSON Feature. Vamos centralizar o círculo em latitude: 47,639754 e Longitude:-122,126986 e atribuir a ele 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 dá suporte à geometria Rectangle. O objeto GeoJSON Polygon Feature é usado para representar um retângulo. A extensão de retângulo é usada principalmente pelo módulo de ferramentas de desenho do SDK da Web.

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

Coordenada	Propriedade
Cantos	Os cantos do retângulo são representados usando as coordenadas de um objeto `GeoJSON Polygon`. Deve haver cinco coordenadas, uma para cada canto. e uma quinta coordenada que seja igual à primeira coordenada para fechar o anel do polígono. Presume-se que essas coordenadas se alinhem e que o desenvolvedor possa girá-las conforme desejado.
SubType	A geometria do retângulo também deve conter a propriedade `subType`. Essa propriedade deve fazer parte das propriedades `GeoJSON Feature` e o valor deve ser Retângulo.

Exemplo de retângulo

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

Próximas etapas

Saiba mais sobre dados GeoJSON no Azure Mapas:

Formato GeoJSON de cerca geográfica

Examine o glossário de termos técnicos comuns associados a aplicativos do Azure Mapas e de inteligência de localização:

Glossário do Azure Mapas

Compartilhar via