El API REST del Geoportal
El API REST del Geoportal permite que a cada registro de metadatos en el catálogo del geoportal se le asigne una URL única accesible en la Web. El catálogo del Geoportal también se puede consultar mediante las URL con la sintaxis de REST. Acceder a los documentos de metadatos individuales a través de sus URL de REST o a grupos de documentos que coinciden con un criterio de búsqueda específico a través de una URL de búsqueda con formato REST, proporciona una funcionalidad poderosa para la búsqueda, visualización y para compartir registros. Por ejemplo, puede enviar la URL a un documento de metadatos o una búsqueda a colegas y ellos podrán acceder a esos recursos sin tener que ir al geoportal y realizar su propia búsqueda. Gracias a la integración de las URL en otras páginas web, o en el sistema de administración del contenido de su organización, los usuarios pueden disponer de vínculos rápidos a los recursos sin tener que hacer ellos sus propias búsquedas. Adicionalmente, el API REST permite la integración fácil con las aplicaciones externas, como se describe a continuación.
Para ver las URL de REST de un registro de metadatos individual, haga clic en el vínculo Detalles para obtener el registro en los resultados de búsqueda y desplácese hasta la parte inferior de la página Detalles. La URL tendrá un formato similar al siguiente, con un GUID único: /geoportal/rest/document?f=html&id=%7B<GUID>%7D.
Para ver los resultados con formato REST para una búsqueda específica, desplácese hasta la parte inferior de los resultados de búsqueda del geoportal después de haber realizado una búsqueda para ver vínculos de la búsqueda en formato GEORSS, ATOM, HTML, FRAGMENT, KML y JSON REST. Cada formato REST se describe en la tabla de a continuación, con un ejemplo de cómo se puede usar ese formato en una aplicación externa.
| Formato REST | Descripción | Aplicación externa |
|---|---|---|
GEORSS | Ver los resultados en formato GEORSS; también permite a los usuarios suscribirse a una fuente RSS de los registros que coincidan con los criterios de búsqueda | Lectores de RSS como Microsoft Outlook, Microsoft Internet Explorer y Mozilla Firefox |
ATOM | Ver los resultados en formato ATOM, otro estándar para recuperar envíos de información por suscripción que también permite que los usuarios se suscriban a actualizaciones | Lectores de RSS como Microsoft Outlook, Microsoft Internet Explorer y Mozilla Firefox |
HTML | Los formatos se obtienen como un documento HTML completo | Sistemas de administración de contenido y wikis, como Microsoft SharePoint, Joomla! y Apache JSPWiki |
FRAGMENT | Los formatos se obtienen como un fragmento de HTML sin las etiquetas <html>, <head>, <title> ni <body> | Sistemas de administración de contenido y wikis, como Microsoft SharePoint, Joomla! y Apache JSPWiki |
KML | Los formatos se obtienen en KML, permitiendo visualizar los resultados de búsqueda en aplicaciones de representación cartográfica en la web. | Aplicaciones de representación cartográfica, como Google Maps y Google Earth |
JSON | La impresión con sangría se obtiene en formato JSON | Aplicaciones personalizadas |
La API REST también permite buscar directamente en el Geoportal desde un navegador web con la funcionalidad OpenSearch. Las posibilidades para integrar su catálogo de Geoportal en otras aplicaciones son ilimitadas, lo que aumenta la importancia y exposición del catálogo de metadatos.