Introducción: ¿Qué es OSM y el HOT?¶

Misión y Objetivos del Equipo Humanitario de OSM¶

Toma de datos¶

Los datos se recopilan por observación directa, preferentemente empleando GPS, aunque pueden emplearse otros medios como fotografía aérea si los derechos de la imagen lo permite. Aún así el proyecto recomienda conocer y recorrer la zona personalmente para garantizar la máxima calidad del resultado.

Los orígenes más comunes de datos son:

• Trazas GPS, resultado de recorrer la zona usando un dispositivo GPS que almacene dicha información.
  • También suelen usarse waypoints, fotos geolocalizadas y archivos de audio geolocalizados
• Imágenes de Yahoo, Bing Maps, el PNOA en España, Landsat y en general cualquier imagen cuyos derechos de autor hayan sido expresamente cedidos, se hayan extinguido o estén en el dominio público.
• Mapas e información de los usuarios. Siempre que se trate de información en el dominio público o cuyos derechos de autor hayan sido expresamente cedidos.
• Información previa existente que requiera ser incluida en un mapa.

Subida de datos a los servidores de OpenStreetMap¶

Una vez recopilada la información, esta debe ser incorporada a la base de datos de OSM. Para ello existen diversos medios, aunque principalmente se emplean clientes web como iD:

y el cliente de escritorio JOSM:

En cualquier caso lo más frecuente es convertir los datos GPS tomados al formato estándar GPX y subirlos posteriormente al repositorio de trazas GPS de OSM de forma que cualquier usuario pueda acceder a dicha información.

Renderizado de los mapas¶

El proyecto OSM tiene varios motores de renderizado que permiten obtener una imagen de la información de la base de datos. El principal motor de renderizado es el que utiliza la biblioteca Mapnik. Un proceso automático toma los datos desde la base de datos principal y los carga en una base de datos Postgresql/PostGIS para posteriormente renderizar tiles de 256x256 que son normalmente consumidos desde la web principal del proyecto.

La API de OSM¶

La API de OSM es el único medio de modificar datos de la base de datos. Todas las aplicaciones que quieran obtener datos y subir datos a la base de datos de OSM lo tienen que hacer usando dicha API.

La versión actual de la API es la v0.6 y su uso es obligatorio desde 2009.

La API es una API RESTful de edición, esto quiere decir que utiliza directamente el HTTP para manipular la información y que recibe los mensajes y resultados en formato XML.

Toas las consultas se realizan de forma anónima, pero las actualizaciones se realizan usando OAuth (son necesarios un usuario y una contraseña válidos)

La API da soporte de versionado directamente, de forma que todas las actualizaciones quedan registradas con un número de versión de forma que permite detectar errores y conflictos de manera eficiente.

Las descargas están limitadas a cuadrados de 15’ de arco y además existe una limitación de ancho de banda, de forma que si se excede la primera limitación el sistema responde un mensaje de error y si se excede la segunda se bloquearán los accesos de manera temporal.

La API no está enfocada a consulta, sino a edición, para consultar la base de datos es más eficiente emplear otros métodos que básicamente consisten en obtener uno de los archivos Planet, convertirlo a una base de datos local y consultar sobre ésta.

Ejemplos de actualización de datos:

PUT /api/0.6/changeset/create
PUT /api/0.6/changeset/#id/close
PUT /api/0.6/[N|W|R]/create
DELETE /api/0.6/[N|W|R]/#id

Ejemplo de respuesta:

<osm>
  <changeset>
    <tag k="created_by" v="JOSM 1.61"/>
    <tag k="comment" v="Just adding some streetnames"/>
    ...
  </changeset>
  ...
</osm>

Ejemplos de consultas:

GET /api/0.6/[N|W|R]/#id/relations
GET /api/0.6/node/#id/ways
GET /api/0.6/[W|R]/#id/full

Ejemplo de respuesta:

<?xml version="1.0" encoding="UTF-8"?>
<osm version="0.6" generator="OpenStreetMap server">
  <gpx_file id="836619" name="track.gpx" lat="52.0194" lon="8.51807"
            user="Hartmut Holzgraefe" visibility="public" pending="false"
            timestamp="2010-10-09T09:24:19Z">
    <description>PHP upload test</description>
    <tag>test</tag>
    <tag>php</tag>
  </gpx_file>
</osm>

OSM XML Data: el formato OpenStreetMap¶

El formato de intercambio estándar de la API es un XML compuesto por combinaciones de los cuatro elementos principales.

Los Nodos tienen, entre otras informaciones, las siguientes características:

• id: el identificador
• lat y lon: la posición geográfica en EPSG4326
• visible: boolean que determina la visibilidad
• user: usuario que creó la versión del nodo
• timestamp: marca de tiempo de creación
• version: incremental para cada objeto.

Además el Nodo puede contener información asociada al estilo OSM a traves de pares key/value

<node id="25496583" lat="51.5173639" lon="-0.140043" version="1"
    changeset="203496" user="80n" uid="1238" visible="true"
    timestamp="2007-01-28T11:40:26Z">
    <tag k="highway" v="traffic_signals"/>
</node>

Las Vías son listas ordenadas de nodos que tienen información como:

• id: el identificador
• visible: boolean que determina la visibilidad
• user: usuario que creó el nodo
• timestamp: marca de tiempo de creación
• version: incremental para cada objeto.

Debe tener una lista de nodos agrupados cada uno con su etiqueta XML nd con la referencia id de los nodos que agrupa. Además la Vía puede contener información asociada al estilo OSM a traves de pares key/value

<way id="5090250" visible="true" timestamp="2009-01-19T19:07:25Z"
    version="8" changeset="816806" user="Blumpsy" uid="64226">
    <nd ref="822403"/>
    <nd ref="21533912"/>
    <nd ref="821601"/>
    <nd ref="21533910"/>
    <nd ref="135791608"/>
    <nd ref="333725784"/>
    <nd ref="333725781"/>
    <nd ref="333725774"/>
    <nd ref="333725776"/>
    <nd ref="823771"/>
    <tag k="highway" v="unclassified"/>
    <tag k="name" v="Clipstone Street"/>
    <tag k="oneway" v="yes"/>
</way>

Las Relaciones son listas ordenadas de objetos, son objetos en si mismas y sirven para definir relaciones entre cualquier tipo de objeto. También tienen información como:

• id: el identificador
• visible: boolean que determina la visibilidad
• user: usuario que creó el nodo
• timestamp: marca de tiempo de creación

Y además en una etiqueta XML member definir atributos type, id y role que permiten configurar la relación y unas etiquetas tag para describir el tipo de relación.

<relation id="77" visible="true"
    timestamp="2006-03-14T10:07:23+00:00" user="fred">
    <member type="way" id="343" role="from" />
    <member type="node" id="911" role="via" />
    <member type="way" id="227" role="to" />
    <tag k="type" v="restriction"/>
    <tag k="type" v="no_left_turn"/>
</relation>

Pese a ser una primitiva reconocida por la API de OSM en realidad está integrada dentro de las otras primitivas y nos permite definir los atributos de las mismas.