Estándares de datos abiertos, APIs y política municipal de Seattle
Seattle, Washington mantiene un programa de datos abiertos para publicar conjuntos de datos municipales, proporcionar acceso por API y establecer expectativas de metadatos y licencias para editores y desarrolladores externos. Esta guía resume los estándares de publicación, prácticas técnicas de API, funciones de gobernanza y vías de cumplimiento que utiliza la Ciudad de Seattle para gestionar conjuntos de datos abiertos y el acceso de desarrolladores.
Resumen
La Ciudad publica conjuntos de datos a través de su portal oficial y espera metadatos estandarizados, formatos legibles por máquina, actualizaciones periódicas y licencias claras. Los conjuntos de datos se alojan en el portal de datos abiertos de la Ciudad de Seattle para descubrimiento y acceso por API mediante endpoints estándar y herramientas para desarrolladores. Para el portal oficial consulte data.seattle.gov[1].
- Estándar de metadatos: incluir título, descripción, campos, frecuencia de actualización, contacto y licencia.
- Formatos: proporcionar CSV, GeoJSON, JSON u otras exportaciones legibles por máquina cuando sea posible.
- Oportunidad: indicar la fecha de última actualización y la frecuencia en los metadatos.
- Licencias: indicar claramente una licencia abierta o los términos de uso permitidos en los metadatos del conjunto de datos.
APIs, acceso y estándares técnicos
Las APIs generalmente siguen endpoints comunes de datos abiertos y admiten consultas RESTful, paginación y filtrado; muchos conjuntos de datos exponen endpoints al estilo Socrata o compatibles con CKAN según la plataforma. Use identificadores de recursos estables, incluya detalles del esquema y documente ejemplos de consultas y límites de tasa cuando corresponda.
- Documentación de API: publique ejemplos de endpoints y descripciones de parámetros en la documentación del conjunto de datos.
- Esquema: incluya tipos de campo, sistemas de referencia de coordenadas para datos espaciales y registros de ejemplo.
- Seguridad: evite incluir datos personales sensibles o restringidos; siga la guía de privacidad y registros públicos.
- Límites de tasa: documente la limitación de solicitudes de la API y prácticas recomendadas para exportaciones masivas.
Sanciones y aplicación
Las páginas públicas de datos abiertos de la Ciudad de Seattle describen estándares y gobernanza, pero no especifican sanciones monetarias o multas en las páginas del portal; los mecanismos de aplicación específicos y las multas no están especificados en la página citada. Para el portal oficial consulte data.seattle.gov[1].
- Multas: no especificado en la página citada.
- Escalamiento: los procedimientos para infracciones iniciales, repetidas o continuas no están especificados en la página citada.
- Sanciones no monetarias: órdenes para eliminar o editar conjuntos de datos, restricción de privilegios de publicación o remisión a revisión legal municipal pueden usarse; los detalles no están especificados en la página citada.
- Aplicador y contacto: Seattle Information Technology (Seattle IT) administra el programa de datos abiertos; para problemas con conjuntos de datos consulte el contacto del portal o los canales de Seattle IT disponibles en el sitio de la Ciudad.
Los recursos de apelación, revisión y límites de tiempo formales para acciones de aplicación no se detallan en las páginas del portal; consulte con Seattle IT o la Oficina del Procurador Municipal para procedimientos formales de revisión.
Solicitudes y formularios
La Ciudad no publica un formulario universal en papel para la publicación de conjuntos de datos en el portal; la presentación de conjuntos de datos y la incorporación de APIs se gestionan típicamente mediante la interfaz del portal o contactando al personal de Seattle IT. Si se requiere un formulario específico, aparecerá en la página del programa o del conjunto de datos; no hay nombre de formulario o tarifa universal especificada en la página citada.
Cumplimiento y buenas prácticas
Los editores deben eliminar o enmascarar datos personales cuando la ley lo exija, incluir procedencia y cronogramas de actualización, y proporcionar puntos de contacto claros para correcciones o retiros. Mantenga una licencia clara y supervise el uso del conjunto de datos para detectar usos indebidos.
- Mantenimiento: asigne un responsable del conjunto de datos y publique la cadencia de actualización en los metadatos.
- Registros: conserve el esquema original y los registros de cambios para apoyar auditorías.
- Revisión de privacidad: realice una evaluación de privacidad antes de publicar conjuntos de datos que contengan información potencialmente identificable.
FAQ
- ¿Quién administra el portal de datos abiertos de Seattle?
- La Ciudad de Seattle opera su portal y programa de datos abiertos a través de Seattle IT y departamentos relacionados; consulte el portal para contactos y propietarios de conjuntos de datos.
- ¿Se requiere una clave API para usar los conjuntos de datos?
- Muchos conjuntos de datos son accesibles sin una clave API para consultas de lectura; las claves autenticadas pueden utilizarse para límites de tasa más altos o acceso de escritura si la plataforma del conjunto de datos lo soporta.
- ¿Qué licencia se aplica a los conjuntos de datos municipales?
- La licencia es específica de cada conjunto de datos; cada conjunto debe indicar su licencia en los metadatos—si no se muestra una licencia, consulte la página del conjunto de datos o contacte al propietario a través del portal.
How-To
- Prepare su conjunto de datos: limpie los campos, elija un formato legible por máquina e incluya metadatos descriptivos con frecuencia de actualización y contacto.
- Crear la entrada del conjunto de datos: cree la entrada en el portal de la Ciudad o contacte a Seattle IT para solicitar la incorporación.
- Publique y documente endpoints de API: publique y documente endpoints y ejemplos para desarrolladores, incluyendo consultas de ejemplo y esquemas de respuesta esperados.
- Monitoree y actualice: supervise el uso, responda consultas y actualice los metadatos cuando el conjunto de datos cambie.
Puntos clave
- Use metadatos estandarizados y formatos legibles por máquina para maximizar la reutilización.
- Coordine con Seattle IT para incorporación, revisiones de privacidad y orientación sobre APIs.
- La licencia y la frecuencia de actualización deben figurar claramente en cada página de conjunto de datos.
Ayuda y recursos
- Portal de datos abiertos de la Ciudad de Seattle
- Seattle Information Technology
- Código municipal de Seattle (Municode)