Explorador de servicios ArcGIS REST

Qué es un directorio de servicios ArcGIS REST

ArcGIS Server y ArcGIS Enterprise publican cada servicio de mapas, servicio de entidades y servicio de imágenes a través de una interfaz REST. Su raíz suele tener la forma …/arcgis/rest/services, y debajo se encuentran las carpetas, los servicios (MapServer, FeatureServer, ImageServer y otros) y las capas y tablas de cada servicio. Las capas de entidades alojadas en ArcGIS Online siguen la misma estructura. Si añade ?f=json a cualquiera de estas URL, el recurso se describe a sí mismo en un formato legible por máquina: nombre, tipo de geometría, referencia espacial, campos y operaciones admitidas.

Este explorador lee esas descripciones JSON y las convierte en un árbol ordenado y en tablas de resumen. Ya no hace falta recorrer las páginas REST una por una para ver qué capas contiene un servicio, comprobar el tipo de un campo o sus valores codificados, saber cuántas entidades tiene una capa o echarle un vistazo rápido en el mapa.

Cómo se usa

1. Pegue la URL de un directorio de servicios, una carpeta, un servicio o una sola capa, por ejemplo …/rest/services, …/rest/services/Carpeta/Servicio/MapServer o …/FeatureServer/0. Los sufijos como ?f=pjson no son un problema.
2. Pulse Leer servicio. Las carpetas y los servicios aparecen en el árbol; al hacer clic en una carpeta o un servicio se carga su contenido. Las capas de grupo se muestran con sus subcapas.
3. Seleccione una capa o una tabla. El panel de detalles muestra el nombre, el tipo, el tipo de geometría, la referencia espacial (wkid y latestWkid), la extensión, maxRecordCount, las capacidades, la versión y el número de entidades, y debajo aparece la tabla de campos. El mapa se acerca a la extensión de la capa, dibujada con una línea discontinua.
4. Si lo desea, escriba una cláusula where y seleccione solo los campos que necesite. Con Vista previa en el mapa las entidades se cargan página a página mientras una barra de progreso indica cuántas han llegado. Haga clic en una entidad del mapa para ver sus atributos.
5. Descargue los registros cargados en GeoJSON, CSV o KML.

Filtro, paginación y límite de registros

El campo where es una condición de tipo SQL que se pasa directamente a la operación de consulta del servicio. Los números se escriben como POP2000 > 100000 y el texto entre comillas simples, como en STATE_NAME = 'Texas'. Los nombres de campo deben coincidir con los de la tabla de campos. Después de cambiar la condición, el botón # actualiza el número de entidades.

Un servicio devuelve como máximo maxRecordCount entidades por solicitud. Para superar ese límite, la herramienta pagina los datos: si el servicio lo admite, avanza en orden de ObjectID con resultOffset y resultRecordCount; si no, obtiene primero la lista de ObjectID y después solicita las entidades por lotes. El límite predeterminado es de 2000 entidades y puede ampliarse hasta 10.000. En capas más grandes, dividir la descarga con una cláusula where es más razonable tanto para su navegador como para el servicio.

Formatos de exportación

• GeoJSON: las coordenadas están en WGS84 (EPSG:4326), en orden longitud, latitud. Si el servicio admite salida GeoJSON, se usa directamente; si no, la respuesta en Esri JSON se convierte a GeoJSON en el navegador, y los anillos exteriores de los polígonos se separan de los huecos según la orientación del anillo.
• CSV: los campos seleccionados pasan a ser columnas. La geometría se escribe en una única columna WKT; en capas de puntos puede elegir en su lugar columnas X (longitud) e Y (latitud). Los campos de fecha se convierten a ISO 8601. El archivo se guarda en UTF-8 con BOM para que las tildes y la ñ se vean correctamente en hojas de cálculo como Excel.
• KML: cada entidad se convierte en un Placemark cuyo nombre procede del campo de visualización de la capa; los atributos se guardan en ExtendedData.

Servicios protegidos y tokens

Los servicios que no son públicos devuelven 499 (Token Required). Si tiene autorización, puede introducir en el campo de token opcional un token obtenido de su propio portal o servidor. El token se conserva solo en memoria, viaja en el cuerpo de la solicitud únicamente al servidor que usted ha introducido y nunca se añade a las URL que se muestran en pantalla. En las organizaciones, decidir quién puede acceder a los servicios protegidos, durante cuánto tiempo y desde qué aplicaciones, así como la forma de emitir y renovar los tokens, es una tarea de gestión en sí misma. Proxy Token Manager de Rodosto la aborda en la capa de proxy y token; encontrará más información en rodostoteknoloji.com.

Datos y método

La herramienta utiliza los puntos finales estándar de la API REST de ArcGIS: f=json para las definiciones del directorio, los servicios y las capas, returnCountOnly para el número de entidades, returnExtentOnly para la extensión y la operación query con outSR=4326 para la vista previa. Todas las solicitudes van directamente desde su navegador al servidor que usted ha introducido y no pasan por los servidores de Rodosto, por lo que el servidor debe permitir solicitudes del navegador (CORS). Los iconos proceden de Lucide (licencia ISC). Los mapas base pertenecen a Esri y a los colaboradores de OpenStreetMap. Bibliotecas de código abierto utilizadas y sus licencias: Fuentes de datos.

Limitaciones

• CORS y redes internas: los servidores que bloquean las solicitudes del navegador o que solo son accesibles desde una red interna no pueden leerse desde esta página. La herramienta lo indica cuando ocurre.
• URL con HTTP: como la página se abre con HTTPS, las URL que empiezan por http se prueban primero con https. Si el servidor no admite HTTPS, el navegador bloquea la solicitud.
• Servicios de imágenes: en ImageServer y en los servicios de mapas en caché se muestran los detalles y la extensión; no se descargan datos de píxeles.
• Derecho de uso: que un servicio sea público no significa que sus datos puedan usarse para cualquier fin. Descargue datos solo de servicios que tenga derecho a usar; se aplican las condiciones de uso del propietario del servicio.

Para organizaciones

Rodosto es Partner de Esri y trabaja en implantaciones de ArcGIS Enterprise, publicación de servicios y acceso seguro a servicios de ArcGIS. Encontrará más información sobre nuestro trabajo en rodostoteknoloji.com y puede escribirnos desde la página de contacto.