Documentación de la API EMBEDED
La API EMBEDED nos permite incrustar un mapa en una página web de una forma sencilla. Para ello lo único que hay que hacer es añadir un iframe a la página y utilizar como src la siguiente url:
http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic
Esta url acepta los siguientes parámetros:
| Nombre | Descripción | Posibles valores | Valor por defecto |
| view | Indica qué tipo de mapa queremos usar | {map, ortho, picto} | ortho |
| width | Ancho del mapa embebido | int | |
| height | Alto del mapa embebido | int | |
| orientation | Se utiliza junto con el parámetro view=picto. Indica cuál de las cuatro vistas disponibles de pictometry queremos usar. | ||
| lon | Longitud en el sistema de proyección Mercator | float | |
| lat | Latitud en el sistema de proyección Mercator | float | |
| zoom | Este valor indica el factor de zoom que queremos aplicar al mapa | (0..19) | |
| show_zoom_bar | Indica si queremos mostrar los controles de zoom y desplazamiento | {true, false} | false |
| text | Muestra un popup con el texto anclado en la latitud y longitud especificada en los parametros lat y lon | ||
| background | Indica qué tipo de mapa queremos usar de fondo | {osm, googlemaps-normal, googlemaps-satellite, yahoomaps-reg, yahoomaps-sat, microsoftmaps-road, microsoftmaps-aerial} | osm |
Ejemplos:
Mapa Básico
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic" frameborder="0" width="450" height="350"></iframe>
Mapa con los controles de zoom y desplazamiento
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic?show_zoom_bar=true" frameborder="0" width="450" height="350"></iframe>
Mapa con los controles de zoom y desplazamiento y usando la vista "map"
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic?show_zoom_bar=true&view=map" frameborder="0" width="450" height="350"></iframe>
Mapa con los controles de zoom y desplazamiento, posicionado en la latitud: 43.28461, longitud: -2.170486
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic?show_zoom_bar=true&lon=-2.170486&lat=43.28461" frameborder="0" width="450" height="350"></iframe>
Mapa con los controles de zoom y desplazamiento, posicionado en la latitud: 43.28461, longitud: -2.170486 y factor de Zoom de 18
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic?show_zoom_bar=true&lon=-2.170486&lat=43.28461&zoom=18" frameborder="0" width="450" height="350"></iframe>
Mapa posicionado en la latitud: 43.32478, longitud: -1.978784 y texto
<iframe src="http://b5m.gipuzkoa.eus/api/1.0/es/embedded/basic?lat=43.32478&lon=-1.978784&zoom=16&text=%3Cstrong%3EKursaal%3C/strong%3E%3Cp%3EAv.%20Zurriola,%201%3Cbr%20/%3E20002%20Donostia-San%20Sebastian%3Cbr%20/%3ETel%C3%A9fono.%20+34%20943%2000%2030%2000%20-%20Fax:%20+34%20943%2000%2030%2001%3C/p%3E%3Cp%20style=%27text-align:center;%27%3E%3Ca%20href=%27http://www.kursaal.es%27%3Ewww.kursaal.es%3C/a%3E" frameborder="0" width="450" height="350"></iframe>
