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. También se pueden hacer consultas en el catálogo del geoportal a través de las URL mediante 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 gestión de 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 para un registro de metadatos individual, haga clic en el vínculo 'Detalles' para obtener el registro en una lista de resultados de búsqueda y desplácese hacia la parte inferior de la página Detalles. La URL se formateará de forma similar a lo siguiente, con un GUID único que reemplaza al que se muestra aquí en cursiva.
/geoportal/rest/document?f=html&id=%7BF6B6CCA6-9013-4018-9FFE-5F8163E27FBD%7D
Para ver los resultados con formato REST para una búsqueda específica, desplácese hacia la parte inferior de la página de resultados de búsqueda del geoportal después de haber realizado una búsqueda con sus criterios de interés. Verá vínculos para visualizar la búsqueda en formato GEORSS, ATOM, HTML, FRAGMENT, KML o 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 2007, 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 2007, Microsoft® Internet Explorer y Mozilla Firefox |
HTML | Los formatos se obtienen como un documento HTML completo | Sistemas de gestión de contenido y wikis, como Microsoft® SharePoint, Joomla!™ y JSPWiki |
FRAGMENT | Los formatos se obtienen como un fragmento del documento HTML, sin etiquetas <html>,<head>,<title> o <body> | Sistemas de gestión de contenido y wikis, como Microsoft® SharePoint, Joomla!™ y 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 mapas, como Google™ Maps, Google™ Earth o Microsoft® Virtual Earth |
JSON | Los resultados se obtienen en formato JSON de fácil lectura | Aplicaciones personalizadas, como el desarrollo de widgets para Microsoft® Silverlight |
El API REST también permite a los usuarios buscar directamente en el Geoportal desde su navegador gracias a la funcionalidad OpenSearch. Existen posibilidades ilimitadas para la forma en que el catálogo del Geoportal se puede integrar en otras aplicaciones, otorgándole así al catálogo de metadatos mayor prominencia y exposición.