Geometria e atributos de um lugar
O GeoJSON é um formato baseado em JSON para descrever formas e localizações geográficas. Uma geometria pode representar um ponto ou uma área. Um objeto Feature associa essa geometria a atributos, como o nome do local. Para reunir várias dessas feições no mesmo objeto, o formato oferece a FeatureCollection.
A RFC 7946 define o uso do sistema de referência WGS 84. Nas posições com duas coordenadas, a longitude vem primeiro e a latitude vem depois, ambas em graus decimais. A ordem precisa ser preservada durante a troca entre aplicações.
Leitura de um ponto com nome
Este exemplo didático associa o nome de um ponto de atendimento a uma localização:
{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-46.63, -23.55] }, "properties": { "nome": "Atendimento de exemplo" }}O campo geometry descreve um ponto com longitude -46.63 e latitude -23.55. O nome está em properties e não altera a posição. Uma aplicação de visualização geográfica pode usar a geometria para posicionar um marcador e o nome para identificá-lo.
A troca das coordenadas para [-23.55, -46.63] produz outro local, embora o JSON continue sintaticamente válido. Ao conferir uma importação, você precisa comparar a ordem das coordenadas com a origem do arquivo. A exibição do marcador, por si só, não confirma que a localização esteja correta.
Dúvidas frequentes
Perguntas frequentes sobre GeoJSON
- Qual é a ordem das coordenadas no GeoJSON?
- As duas primeiras coordenadas são longitude e latitude, em graus decimais. Uma terceira coordenada pode informar a altitude em metros conforme a RFC 7946.
- Qual é a diferença entre Geometry e Feature?
- Uma Geometry descreve a forma geográfica. Uma Feature associa uma geometria ao campo properties, que pode guardar atributos como o nome de um ponto de atendimento.
- Um arquivo JSON válido também é um GeoJSON válido?
- A validade da sintaxe JSON é apenas uma das verificações. O GeoJSON exige tipos e estruturas próprios, como o campo coordinates com uma posição para a geometria Point.
Para continuar
Recursos relacionados
Documentação
RFC 7946: geometrias e propriedades geográficas
Especificação do formato, dos tipos de geometria e do sistema de coordenadas adotado pelo GeoJSON.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão com orientação técnica ao vivo para revisar integrações de localização e interpretar coordenadas recebidas pela aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Aplicações com localização precisam interpretar as coordenadas e validar a estrutura geográfica recebida pelas integrações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.