Usar API REST del Geoportal
En este tema
El API REST en el 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 por medio de las URL usando la sintaxis 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. La integración de las URL en otras páginas Web o en el Sistema de administración de contenido de la organización, proporciona a los usuarios vínculos de conexión rápida a recursos sin tener que hacer su propia búsqueda. 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 le permite a los usuarios suscribirse a una fuente RSS de registros que coinciden 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 administració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 administració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 para representar en mapas tales como Google™ Maps, Google™ Earth, Microsoft® Virtual Earth |
JSON | Los formatos se obtienen en JSON 'pretty' | Aplicaciones personalizadas, como el desarrollo de widgets para Microsoft® Silverlight |
El API REST también permite a los usuarios la búsqueda directamente en el Geoportal desde el navegador a través del recurso 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.