DFG Web Services – APIs por URL

DFG Web Services – APIs por URL
Acceso a las funcionalidades de la página 1:5000 Web por URL.
La mayor parte de las funcionalidades de la web b5m puede ser accedida
directamente a través de URLs mediante una serie de parámetros.
Acceso directo a la interfaz web mediante la búsqueda de un topónimo.
Se puede acceder a la pagina Web b5m efectuando la búsqueda de un topónimo
mediante una URL.
http://b5m.gipuzkoa.net/web5000/default.php?search=valortoponimo&lengua=v
alorlengua&actu=valoractu
Los parámetros “actu” y “lengua” son opcionales.
Los valores indicados en negrita deben ser sustituidos por valores reales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Cadena del
valortoponimo
aduana 13
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
Indica si se
valoractu
0 (por defecto)/1
topónimo a
buscar
visualizan los
códigos de los
topónimos. Estos
códigos servirán
para localizar el
topónimo.
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Ejemplo:
http://b5m.gipuzkoa.net/web5000/default.php?search=irun&lengua=1&actu=1
Acceso directo a la interfaz web mediante la localización de un elemento
geográfico.
Se puede acceder a la página Web b5m localizando cualquier elemento geográfico.
http://b5m.gipuzkoa.net/url5000/index.php?id=tema_id&lengua=valorlengua&ac
tu=valoractu&categoria=valorcategoria&vis_capas=valorlistacapas&escala_fija
=valorescala
Los parámetros “actu”, “categoria”, “vis_capas” y “escala_fija” son opcionales.
Los valores indicados en negrita deben ser sustituidos por valores reales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Identificador del
tema_id
ver valores mas abajo
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
Indica si se
valoractu
0 (por defecto)/1
valorcategoria
PUBLI/PUBLI_FOTO
valorlistacapas
C*Actividades/s//Farmacias/s
valorescala
(por defecto vacio)/4000 (numérico)
elemento
geográfico
visualizan
codigos
Escenario de
visualización
Temas a
activar/desactivar
dependiendo del
escenario de
visualización
elegido
Escala
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Tabla de identificadores de los elementos geográficos:
Descripción
Parámetro
Valores de ejemplo
Comarcas
id=S_codcomarca
id=S_3
Municipios
id=M_codmuni
id=M_045
Calles como
id=K_codmuni_codcalle
id=K_003_1110
Calles como vial
id=V_codmuni_codcalle
id=V_003_1110
Distritos y
id=SC_codmuni_coddistri
id=SC_045_01_003
id=D_idpostal
id=D_4545
id=F_codmuni_codcalle_portal
id=F_045_1110_003
Edificios
id=E_idarea
id=E_33360
Carreteras y tren
id=T_codcarre
id=T_9044
Puntos
id=T_codcarre_pk
id=T_9044_1.4
id=B_idarea
id=B_12402
id=Z_idbarrio
id=Z_13363
Cuencas
id=C_codcuenca
id=C_11
Núcleos
id=N_codnucleo
id=N_30145
Rios
id=I_idrio
id=I_13209
Orografía
id=O_idarea
id=O_19171
id=Z_idbarrio
id=Z_13363
id=X_x_y
id=X_582570.5_4797178
conjunto de
edificios
secciones
Direcciones
postales
Direcciones
postales
kilométricos
Barrios (código
de área)
Barrios (código
de nombre)
(código de área)
Orografía
(código de
nombre)
Coordenadas
ED50 UTM30N
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Coordenadas
id=L_lon_lat
ED50 geográficas
Coordenadas
id=L_1+58+53.87_43+19+22
id=L_lon_lat_WGS84
id=L_-
WGS84
1+58+53.87_43+19+22_WGS
geográficas
84
Actividades
id=A_idactividad
id=A_11933
Actividades con
id=A_idactividad_idpuerta
id=A_11933_4
Cuadrículas
id=R_cuadricula
id=R_64-57
Cuevas
id=CV_codigo
id=CV_CE0708
Carta megalítica
id=GK_codigo
id=GK_GARK153
Patrimonio de
id=PA_claveinmueble
id=PA_1001751
id=AC_idacta
id=AC_269
id=AC_idacta_idmojon
id=AC_269_360
id=Q_idlevantamiento
id=Q_002
id=Q_idlevantamento_fichero
id=Q_001_6429a1a.dwg
id=EM_codigo
id=EM_AR13019
id=CM_codigo
id=CM_AR13301
Montes publico
id=MP_codmonte
id=MP_1.028.1
Mojón de monte
id=MP_codmonte_idmojon
id=MP_1.028.1_229
id=TU_clave1_clave2_claveN
id=TU_C.1.2_D.4.1.4
puerta
diputación
Limites
municipales
Mojón de
término
municipal
Inventario de
cartografía
digital
Fichero del
inventario de
cartografía
digital
Estaciones
Megaliticas
Monumentos
(áreas)
publico
Recursos de
turismo con sus
claves
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Búsqueda de
id=TU2_ct&vradio=r
id=TU2_C.1.1&vradio=1000
recursos de
&tipoactivi=tipoactivi1_tipoactivi2
&tipoactivi=T.2_T.3
turismo a partir
_
de la localización
tipoactiviN
de un elemento
de turismo con
su clave en un
radio de
búsqueda
Ejemplo:
http://b5m.gipuzkoa.net/url5000/index.php?id=M_045&lengua=0&actu=0&categori
a=PUBLI
Acceso directo a las funcionalidades de la web
Generación de una imagen a partir de un identificador de objeto o par de
coordenadas
Se puede acceder a la página Web b5m, pasando los parámetros de búsqueda.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch id=tema_id pixelX pixelY&save=off&service=RAWIMAGEPROVIDER
&lengua=0&categoria=valorcategoria&vis_capas=valorlistacapas&escala_fija=v
alorescala
Los parametros “categoria”, “vis_capas” y “escala_fij”a son opcionales.
Los valores indicados en negrita deben ser sustituidos por valores reales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Identificador del
tema_id
ver valores indicados arriba
pixelX
800
elemento
geográfico
Tamaño X de la
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
imagen generada
en píxel
Tamaño Y de la
pixelY
500
valorcategoria
PUBLI/PUBLI_FOTO
valorlistacapas
C*Actividades/s//Farmacias/s
valorescala
(por defecto vacio)/4000 (numérico)
imagen generada
en píxel
Escenario de
visualización
Temas a
activar/desactivar
dependiendo del
escenario de
visualización
elegido
Escala
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch id=X_582570.5_4797178 729
416&save=on&service=RAWIMAGEPROVIDER&categoria=PUBLI&escala_fija=&leng
ua=0
Lista de temas disponibles en un escenario dado
Se pueden listar los temas disponibles para un escenario dado. Conociendo estos
temas disponibles, se podrán posteriormente activar/desactivar. Los temas están
organizados en un árbol de 3 ramas: clase, grupo y tema. La clase y el grupo
‘Nada’ permiten subir de un nivel en la jerarquía del árbol.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=li
z.preplot GCInicio 600 600
true&save=on&service=RAWTEXTPROVIDER&categoria=valorcategoria&lengua
=valorlengua
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Parámetros de entrada:
Descripcion
Parametro
Valores de ejemplo
Escenario de
valorcategoria
PUBLI/PUBLI_FOTO
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
visualización
Lengua
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
preplot GCInicio 600 600
true&save=on&service=RAWTEXTPROVIDER&categoria=PUBLI&lengua=0
Parámetros de salida:
valorcategoria,valorclase,valorgrupo,valortema,true,valordescripciontema,
valoractivaciontema,valoractivacionclase,valoractivaciongrupo#
Descripcion
Parametro
Valores de ejemplo
Escenario de
valorcategoria
PUBLI/PUBLI_FOTO
valorclase
Ortofotos
valorgrupo
Nada
Tema
valortema
O01G_045
Descripción del tema
valordescripciontema
Ortofoto 1:5.000 año 2004
Activación/desactivación
valoractivaciontema
true /false
valoractivacionclase
S/N
visualización
Clase a la que
pertenece el tema
(‘Nada’ si no pertenece
a ninguna clase)
Grupo a la que
pertenece el tema
(‘Nada’ si no pertenece
a ninguna clase)
por defecto del tema
Activación/desactivación
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
por defecto de la clase
Activación/desactivación
valoractivaciongrupo
S/N
por defecto del grupo
Activación/desactivación de temas a visualizar
La variable “vis_capas” permite la selección de temas que se quieren añadir o
quitar a los temas configurados por defecto en el escenario indicado. Si no se indica
nada, se visualizaran los temas configurados por defecto. Los grupos y clases llevan
el prefijo de G y C respectivamente mientras los mapas no llevan prefijo.
Por ejemplo en un escenario donde tengamos:
PUBLI,Nada,Sanidad y Social,C_4_5,true,Farmacias,false,S,N#
y
PUBLI,Nada,Turismo,T_12,true,Restaurantes y asadores,false,S,N#
Para activar el tema “Farmacias” y “Restaurantes y asadores”, tendremos que
poner:
vis_capas=C*Nada/s//G*Sanidad y Social/s//Farmacias/s//
C*Nada/s//G*Turismo/s//Restaurantes y asadores/s
En otro escenario donde tengamos:
PUBLI_FOTO,Ortofotos,Nada,O05G_80,true,Ortofoto 1:5.000 año 2005,true,S,S#
y
PUBLI_FOTO,Nada,Nada,c5000pap2,false,Series 1:5.000,false,S,S#
Para desactivar la ortofoto 2005 (activada por defecto en el escenario
PUBLI_FOTO), y activar el mapa histórico 1:5000 papel, tendremos que poner:
vis_capas=Ortofoto 1:5.000 año 2005/n//Series 1:5.000/s
Para desactivar la clase Ortofoto, tendremos que poner:
vis_capas=C*Ortofoto/n
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Ejemplo:
Desactivando ortofoto configurada por defecto (año 2005) y activando mapa
historico:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch id=X_582570.5_4797178 729
416&save=on&service=RAWIMAGEPROVIDER&categoria=PUBLI_FOTO&vis_capas=
Ortofoto 1:5.000 año 2005/n//Series 1:5.000/s&lengua=0
Desactivando ortofoto configurada por defecto (año 2005) y activando otra ortofoto
(año 2001):
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch id=X_582570.5_4797178 729
416&save=on&service=RAWIMAGEPROVIDER&categoria=PUBLI_FOTO&vis_capas=
Ortofoto 1:5.000 año 2005/n//Ortofoto 1:5.000 año 2001/s&lengua=0
Generación de una imagen a partir de una ventana MBR
Se puede generar una imagen a partir de unas coordenadas de ventana (Minimal
Bounding Rectangle) en ED50 UTM30N.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCredibujar pixelX pixelY 10
10&save=off&service=RAWIMAGEPROVIDER&setwind=TRUE&set_x1=X1&set_x2=
X2&set_y1=Y1&set_y2=Y2&lengua=0&categoria=valorcategoria&vis_capas=
valorlistacapas&escala_fija=valorescala
Los parametros “categoria”, “vis_capas” y “escala_fija” son opcionales.
Los valores indicados en negrita deben ser sustituidos por valores reales.
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Tamaño X de la
pixelX
800
pixelY
500
X1,Y1,X2,Y2
580006 4795364 586694 4798426
valorcategoria
PUBLI/PUBLI_FOTO
valorlistacapas
C*Actividades/s//Farmacias/s
valorescala
(por defecto vacio)/4000 (numérico)
imagen generada
en píxel
Tamaño Y de la
imagen generada
en píxel
Coordenadas
ED50 UTM30N de
la ventana
Escenario de
visualización
Temas a
activar/desactivar
dependiendo del
escenario de
visualización
elegido
Escala
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCredibujar 800 500 10
10&save=off&service=RAWIMAGEPROVIDER&setwind=TRUE&set_x1=580006&set_
x2=586694&set_y1=4795364&set_y2=4798426&lengua=0&categoria=PUBLI_FOT
O
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Consulta un tema a partir de un par de coordenadas y de un tema
Se pueden consultar los temas indicados aquí abajo a partir de un par de
coordenadas dado.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.m
ainGCQuery_Reales 10 10 10 10
tema&save=off&service=RAWTEXTPROVIDER&Window_x1=coordX&Window_y1=co
ordY&escala_fija=12000&lengua=valorlengua&actu=valoractu&tipocoord=valorc
oordenadas
Los parámetros “actu” y tipocoord son opcionales.
Los valores indicados en negrita deben ser sustituidos por valores reales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Nombre del tema
tema
EDIFICIO, CALLE, MUNICIPIO, VIAL,
a consultar
TOPONIMIA, RIO, COORDENADAS,
FOTOSAEREAS, CINCOMILES,
CARTOGRAFIA, URBANISMO,
LEGISECTORIAL, CUADRICULA,
ED50EDIF, WGS84EDIF
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
Indica si se
valoractu
0 (por defecto)/1
valorcoordenadas
WGS84
coordX coordY
559514 4777275
visualizan
códigos
Indica el tipo de
coordenadas
Coordenadas en
ED50 UTM30N
-1.986 43.309
del punto de
-1_59_6.5 43_19_19.9
consulta
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Ejemplos:
MUNICIPIO
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
MUNICIPIO&save=off&service=RAWTEXTPROVIDER&Window_x1=559514&Window
_y1=4777275&escala_fija=12000&lengua=0&actu=0
EDIFICIO
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
EDIFICIO&save=off&service=RAWTEXTPROVIDER&Window_x1=582583&Window_y
1=4797168&escala_fija=12000&lengua=0&actu=0
CALCULA EL EDIFICIO CON DIRECCION POSTAL MAS CERCANO EN ED50 o WGS84:
ED50EDIF o WGS84EDIF
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
WGS84EDIF&save=off&service=RAWTEXTPROVIDER&Window_x1=1_59_6.5&Window_y1=43_19_19.9&escala_fija=12000&lengua=0&actu=0
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
ED50EDIF&save=off&service=RAWTEXTPROVIDER&Window_x1=559514.45&Windo
w_y1=4777275.1&escala_fija=12000&lengua=0&actu=0
También podemos usar el parámetro tipocoord=WGS84 y meter las coordenadas en
decimales:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
ED50EDIF&save=off&service=RAWTEXTPROVIDER&Window_x1=1.986&Window_y1=43.309&escala_fija=12000&lengua=1&actu=0&tipocoord=WGS
84
COORDENADAS EN WGS84:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
main GCQuery_Reales 10 10 10 10
COORDENADAS&save=off&service=RAWTEXTPROVIDER&Window_x1=-
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
1.986&Window_y1=43.309&escala_fija=12000&lengua=0&actu=0&tipocoord=WGS
84
Localización de un elemento geográfico
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch.txt tema_id&save=off&service=RAWTEXTPROVIDER
&lengua=valorlengua&actu=valoractu
El parámetro “actu” es opcional.
Los valores indicados en negrita deben ser sustituidos por valores reales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Identificador del
tema_id
ver valores mas abajo
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
Indica si se
valoractu
0 (por defecto)/1
elemento
geográfico
visualizan
codigos
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
URLSearch.txt id=V_003_1112 &save=off&service=RAWTEXTPROVIDER&lengua=2
Búsquedas generando un XML
Búsqueda de recursos de turismo de tipos indicados en un radio de
búsqueda alrededor de un elemento de turismo.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
Turismo2XSearch.txt
id=TU2_valorrectb&vradio=valorradio&lengua=valorlengua&actu=valoractu&ti
poactivi=tipoactivi1_tipocativi2_tipoactiviN&save=off&service=XMLFILE&dtd=h
ttp://b5m.gipuzkoa.net/url5000/genaServerReply-1.0.dtd
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Los parámetros “actu” y “lengua” son opcionales.
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Identificador del
valorrectb
Codigo de un recurso de turismo
valorradio
Valor numerico
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (ingles)
Indica si se
valoractu
0 (por defecto)/1
Tipos de los
tipoactivi1_
T.1 a T.23
recursos de
...
turismo
tipoactiviN
recurso de
turismo alrededor
del cual se
buscan los demás
recursos
Radio de
búsqueda
visualizan
códigos
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
Turismo2XSearch.txt
id=TU2_C.1.1&vradio=1000&tipoactivi=T.2_T.3&save=off&service=XMLFILE&dtd=
http://b5m.gipuzkoa.net/url5000/genaServerReply-1.0.dtd
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Calculo de rutas entre coordenadas ED50 UTM30N (sin tener cuenta de las
restricciones de circulación).
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
RutaXBSearch.txt%20id=RBPR_valortiporuta_XO_YO_Xi_Yi_XD_YD&save=off&
service=XMLFILE&dtd=http://b5m.guipuzkoa.net/url5000/genaServerReply-1.0.dtd
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Tipo de ruta
valortiporuta
c (corta), r (rapida), p (peatonal)
Coordenadas
XO YO
540515 4764958
XD YD
596932 4799372
Xi Yi
560583 4793569
ED50 UTM30N de
origen
Coordenadas
ED50 UTM30N de
destino
Coordenadas
intermedias ED50
UTM30N
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
RutaXBSearch.txt%20id=RBPR_c_540515_4764958_560583_4793569_596932_47
99372&save=off&service=XMLFILE&dtd=http://b5m.gipuzkoa.net/url5000/genaSer
verReply-1.0.dtd
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Calculo de rutas entre recursos de turismo (sin tener cuenta de las
restricciones de circulación).
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
Turismo3XSearch.txt id=TU3_cto_cti_ctd&tiporuta=valortiporuta
&save=off&service=XMLFILE&dtd=http://b5m.gipuzkoa.net/url5000/genaServerRe
ply-1.0.dtd
Parámetros de entrada:
Descripción
Parámetro
Valores de ejemplo
Tipo de ruta
valortiporuta
c (corta), r (rapida), p (peatonal)
Recurso de
cto
D.4.1.7
ctd
C.1.2
cdi
A.3.1.27
turismo de origen
Recurso de
turismo de
destino
Recurso de
turismo
intermedio
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
Turismo3XSearch.txt
id=TU3_D.4.1.7_C.1.2&tiporuta=c&save=off&service=XMLFILE&dtd=http://b5m.gi
puzkoa.net/url5000/genaServerReply-1.0.dtd
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio
DFG Web Services – APIs por URL
Extraer el “image map” de unas coordenadas de ventana (Minimal
Bounding Rectangle) en ED50 UTM30N.
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
preplot GC3D pixelX pixelY xmin ymin xmax
ymax&save=off&service=XMLFILE&categoria=valorcategoria&lengua=valorleng
ua&dtd=http://b5m.gipuzkoa.net/url5000/genaServerReply-1.0.dtd
Parámetros de entrada:
Descripción
Parámetro
Coordenadas
xmin
ED50 UTM30N de
ymax
ymin
Valores de ejemplo
xmax
580006 4795364 586694 4798426
la ventana
Tamaño de la
pixelX pixelY
600 600
Lengua
valorlengua
0 (castellano)/1 (euskera)/2 (inglés)
Escenario de
valorcategoria
PUBLI/PUBLI_FOTO
imagen en pixel
visualización
Ejemplo:
http://b5m.gipuzkoa.net/internet/GenaService?application=dfgweb&command=liz.
preplot GC3D 600 600 567922 4792393 568204
4792675&save=off&service=XMLFILE&categoria=PUBLI&lengua=0&dtd=http://b5m
.gipuzkoa.net/url5000/genaServerReply-1.0.dtd
| Gipuzkoa.net | Departamento de Movilidad y Ordenación del Territorio