API ProGrid

API e documentação

Versão: 1.0.0

API que transforma coordenadas em referenciais clássicos, Córrego Alegre e SAD 69, utilizados oficialmente no Brasil, no atual referencial SIRGAS2000. O objetivo é colaborar com os usuários que fazem uso das informações espaciais no Brasil e que rotineiramente precisam compatibilizar seus dados a um único sistema de referência.

Esta API aceita coordenadas de entrada nos seguintes referenciais e suas respectivas realizações: Córrego Alegre 61 (grade de transformação), Córrego Alegre 7072 (grade de transformação), SAD69 (grade de transformação), SAD69_96 (grade de transformação) e SAD69_96 (parâmetros de transformação). Também são aceitos os seguintes formatos para as coordenadas: cartesianas, geodésicas (sexagesimais e graus decimais) e planas (projeção UTM).

A transformação de coordenadas através de grades é bi-dimensional somente nas componentes horizontais, nas materializações do Córrego Alegre e do SAD 69, a saber:

A materialização de 1961 do Córrego Alegre, referida no ProGriD como Córrego Alegre (1961).
As materializações de 1970 e 1972 do Córrego Alegre, tratadas em conjunto, e referida como Córrego Alegre (1970+1972) no ProGriD.
A materialização original do SAD 69, incluindo apenas a rede clássica, chamada simplesmente de SAD69 Rede Clássica.
A materializacão de 1996 do SAD 69, incluindo apenas a rede clássica, chamada no ProGriD de SAD69/96 Rede Clássica.

No caso da transformação bi-dimensional, além das coordenadas transformadas, também são apresentadas resultado suas respectivas incertezas da transformação.

A transformação entre SAD 69 Técnica Doppler ou GPS (identificação na API sad69_96_gps) e SIRGAS2000 é tri-dimensional e ocorre através dos parâmetros de transformação publicados na Resolução do Presidente do IBGE Nº 1/2005 disponível neste link.

Os formatos de coordenadas aceitos estão associados aos referenciais de entrada conforme opções listadas abaixo:

Córrego Alegre (1961): latitude/longitude e UTM E, N.
Córrego Alegre (1970+1972): latitude/longitude e UTM E, N.
SAD69 Rede Clássica: latitude/longitude e UTM E, N.
SAD69/96 Rede Clássica: latitude/longitude e UTM E, N.
SAD69 Técnica Doppler/GPS: latitude/longitude/altitude geométrica, Cartesianas X, Y, Z, latitude/longitude e UTM E, N.
SIRGAS2000: latitude/longitude/altitude geométrica, Cartesianas X, Y, Z, latitude/longitude e UTM E, N (neste caso há apenas uma conversão de formatos).

Arquivo de Coordenadas

Transformação utilizando um arquivo de coordenadas como entrada de dados.

https://servicodados.ibge.gov.br/api/v1/progrid/arquivo

Parâmetros

Form parameters

Name	Description
arquivo*
referencialEntrada*
tipoCoordenadaEntrada*
tipoCoordenadaSaida
tipoEntrada*
tipoSaida*
email

Responses

Status: 200 - Array com os dados transformados. O resultado pode conter a informação númerica da coordenada ou as informações “FORA DO GRID” (se a coordenada estiver fora dos limites da grade) ou “Coordenadas fora dos limites estabelecidos” (se a coordenada estiver fora dos limites do Brasil).

Schema

Coordenadas em graus decimais

Transformação utilizando coordenada de entrada em grau decimal.

https://servicodados.ibge.gov.br/api/v1/progrid/latlongdec

Parâmetros

Query parameters

Name	Description
lat
long
alt
pontos
referencialEntrada*
tipoCoordenadaSaida

Responses

Status: 200 - Se a lista de pontos for utilizada, a resposta é um array. Se não for, a resposta é um objeto. O resultado pode conter a informação númerica da coordenada ou as informações “FORA DO GRID” (se a coordenada estiver fora dos limites da grade) ou “Coordenadas fora dos limites estabelecidos” (se a coordenada estiver fora dos limites do Brasil).

Schema

Coordenadas em graus sexagesimais

Transformação utilizando coordenada de entrada em graus sexagesimais.

https://servicodados.ibge.gov.br/api/v1/progrid/latlonggms

Parâmetros

Query parameters

Name	Description
glat
mlat
slat
glon
mlon
slon
alt
pontos
referencialEntrada*
tipoCoordenadaSaida

Responses

Status: 200 - Se a lista de pontos for utilizada, a resposta é um array. Se não for, a resposta é um objeto. O resultado pode conter a informação númerica da coordenada ou as informações “FORA DO GRID” (se a coordenada estiver fora dos limites da grade) ou “Coordenadas fora dos limites estabelecidos” (se a coordenada estiver fora dos limites do Brasil).

Schema

Coordenadas em UTM

Transformação utilizando coordenada de entrada UTM.

https://servicodados.ibge.gov.br/api/v1/progrid/utm

Parâmetros

Query parameters

Name	Description
e
n
fuso
pontos
referencialEntrada*
tipoCoordenadaSaida

Responses

Status: 200 - Se a lista de pontos for utilizada, a resposta é um array. Se não for, a resposta é um objeto. O resultado pode conter a informação númerica da coordenada ou as informações “FORA DO GRID” (se a coordenada estiver fora dos limites da grade) ou “Coordenadas fora dos limites estabelecidos” (se a coordenada estiver fora dos limites do Brasil).

Schema

Coordenadas em XYZ

Transformação utilizando coordenada de entrada em XYZ.

https://servicodados.ibge.gov.br/api/v1/progrid/xyz

Parâmetros

Query parameters

Name	Description
x
y
z
pontos
referencialEntrada*
tipoCoordenadaSaida

Responses

Status: 200 - Se a lista de pontos for utilizada, a resposta é um array. Se não for, a resposta é um objeto. O resultado pode conter a informação númerica da coordenada ou as informações “FORA DO GRID” (se a coordenada estiver fora dos limites da grade) ou “Coordenadas fora dos limites estabelecidos” (se a coordenada estiver fora dos limites do Brasil).

Schema

Liberação	Nota
15/07/2018	Texto release

Generated 2023-12-29T10:01:56.620-03:00

API ProGrid

API e documentação

Arquivo de Coordenadas

Parâmetros

Responses

Coordenadas em graus decimais

Parâmetros

Responses

Coordenadas em graus sexagesimais

Parâmetros

Responses

Coordenadas em UTM

Parâmetros

Responses

Coordenadas em XYZ

Parâmetros

Responses

Perguntas frequentes

Notas de liberação