Interface da API
Introdução
Para automatizar a conversão de coordenadas, pode-se utilizar a API Restful. Ou seja, pode-se colocar as coordenadas, códigos do sistema de referência de entrada e saída na URL e receberá uma string json com os resultados.
Grelha
exemplo:2D
https://dgt-webapp.teromovigo.com/pt/transform/transform?x=-8.45322&y=38.56714&area=Portugal%20continental&crsin=4274&crsout=3763&metodo=grelhas
resultados:
{"xout": -27821.168, "yout": -122108.142}
exemplo:2D (DMS)
https://dgt-webapp.teromovigo.com/pt/transform/transform?x=-8°27'11.52"&y=38°34'1.56"&area=Portugal%20continental&crsin=4274&crsout=3763&metodo=grelhas
resultados:
{"xout": -27819.44, "yout": -122112.589}
exemplo:3D https://dgt-webapp.teromovigo.com/pt/transform/transform?x=-8.53234&y=38.56714&z=234.00&area=Portugal%20continental&crsin=4274&crsout=3763&metodo=grelhas&altin=Elipsoidal&altout=Ortometrica
resultados:
{"xout": -34716.976, "yout": -122081.185, "zout": 179.888}
Bursa-Wolf
exemplo:2D
https://dgt-webapp.teromovigo.com/pt/transform/transform?x=60120.415&y=-207760.586&area=Portugal%20continental&crsin=3763&crsout=27493&metodo=bursaWolf
resultados:
{"xout": 60117.042, "yout": -207762.689}
exemplo:2D (DMS)
https://dgt-webapp.teromovigo.com/pt/transform/transform? x=-8°27'2711.52"&y=38°34'271.56"&area=Portugal%20continental&crsin=4274&crsout=3763&metodo=bursaWolf
resultados:
{"xout": -27819.44, "yout": -122112.589}
exemplo:3D
https://dgt-webapp.teromovigo.com/pt/transform/transform?x=60120.415&y=-207760.586&z=316.01&area=Portugal%20continental&crsin=3763&crsout=27493&metodo=bursaWolf&altin=Elipsoidal&altout=Elipsoidal
resultados:
{"xout": 60117.045, "yout": -207762.685, "zout": 262.878}
Parâmetros
| Parâmetros | Obrigatória/opcional | Comentários |
|---|---|---|
| x | Obrigatório | Se forem selecionadas coordenadas geodésicas, representa a longitude. Formato do valor= 67675.76 Ou -9.1345 Ou -9 23 56.4567 |
| y | Obrigatório | Se forem selecionadas coordenadas geodésicas, representa a latitude. Formato do valor= 87987.776 Ou 38.5677 Ou 38 0 35 |
| z | Opcional | Altura. Formato do valor= 456.7 |
| area | Obrigatório | Área de aplicabilidade dos sistemas de referência e suas transformações. |
| crsin | Obrigatório | Código EPSG do sistema de referência de entrada |
| crsout | Obrigatório | Código EPSG do sistema de referência de saída |
| metodo | Obrigatório | Método utilizado para efetuar a transformação dos sistemas de referência. |
| altin | Opcional, exceto se h ou z forem utilizados na entrada. | Indicação do tipo de altitude de entrada. |
| altout | Opcional, exceto se h ou z forem utilizados na saída. | Indicação do tipo de altitude de saída. |
Códigos dos parâmetros
| Parâmetros | Código | Comentários |
|---|---|---|
| area | ||
| Portugal Continental | - | |
| Acores | - | |
| Madeira | - | |
| crsin,crsout | ||
| 3763 | ETRS89/ PT-TM06 | |
| 4937 | ETRS89 - Coordenadas Geográficas | |
| 4936 | ETRS89 - Coordenadas Geocêntricas | |
| 4207 | Datum Lisboa - Coordenadas Geográficas | |
| 4274 | Datum 73 - Coordenadas Geográficas | |
| 5018 | Datum Lisboa/Hayford-Gauss | |
| 20790 | Datum Lisboa/Hayford-Gauss com Falsa Origem | |
| 27493 | Datum 73/Hayford-Gauss | |
| 5014 | ITRF93/PTRA08-UTM 25N - Açores Ocidental | |
| 5015 | ITRF93/PTRA08-UTM 26N - Açores Central e Oriental | |
| 5011 | ITRF93 - Coordenadas Geocêntricas | |
| 2942 | Datum Base SE (Porto Santo)/UTM 28N - Madeira | |
| 5012 | ITRF93 - Coordenadas Geográficas | |
| 2188 | Datum Observatório (Flores)/UTM 25N - Açores Ocidental | |
| 2189 | Datum Base SW (Graciosa)/UTM 26N - Açores Central | |
| 2190 | Datum S. Braz (S. Miguel)/UTM 26N -Açores Oriental | |
| 5016 | ITRF93/PTRA08-UTM 28N - Madeira, Porto Santo, Desertas e Selvagens | |
| 88888 | Datum 73 - Coordenadas Geocêntricas | |
| 99999 | Datum Lisboa - Coordenadas Geocêntricas | |
| 37249 | Datum S. Braz (S. Miguel) - Açores Oriental - Coordenadas Geográficas | |
| 77772 | Datum S. Braz (S. Miguel) - Açores Oriental - Coordenadas Geocêntricas | |
| 37241 | Datum Base SW (Graciosa) - Coordenadas Geográficas | |
| 77771 | Datum Base SW (Graciosa) - Coordenadas Geocêntricas | |
| 37245 | Datum Observatório (Flores) - Coordenadas Geográficas | |
| 77770 | Datum Observatório (Flores) - Coordenadas Geocêntricas | |
| 37247 | Datum Base SE (Porto Santo) - Coordenadas Geográficas | |
| 77773 | Datum Base SE (Porto Santo) - Coordenadas Geocêntricas | |
| metodo | ||
| bursaWolf | Bursa-Wolf | |
| grelhas | Grelha (NTv2), area="Portugal Continental" | |
| altin, altout | ||
| Ortometrica | - | |
| Elipsoidal | - |