Estándares de Publicación de Datos Abiertos y API en Baltimore

Baltimore, Maryland mantiene un portal municipal de datos abiertos y estándares de publicación para que los conjuntos de datos de la ciudad sean detectables, legibles por máquina y reutilizables por residentes, desarrolladores y agencias. Esta guía explica las expectativas de publicación, patrones de acceso a APIs, roles de gobernanza y pasos operativos para publicar o solicitar datos en la plataforma de datos abiertos de Baltimore. Resume quién hace cumplir los estándares, cómo son las infracciones comunes, cómo enviar conjuntos de datos o solicitudes y pasos prácticos para consumir APIs en aplicaciones cívicas. Para documentación oficial del portal consulte el Portal de Datos Abiertos de Baltimore data.baltimorecity.gov^[1].

Qué cubren los estándares

Los estándares de publicación normalmente describen los campos de metadatos requeridos, formatos de archivo aceptables (CSV, GeoJSON, JSON), convenciones de nombres de esquema y campos, expectativas de licencia, cadencia de actualización y la estructura de los endpoints de API. Aconsejan sobre la anonimización de datos personales y la conservación de registros al publicar conjuntos de datos de la ciudad. Las plantillas de metadatos y esquema requeridas se proporcionan a través del portal y deben completarse para cada conjunto de datos antes de la publicación.

Sanciones y Aplicación

La responsabilidad de hacer cumplir la publicación y el cumplimiento de datos abiertos recae en el Departamento de Tecnología de la Información de Baltimore y en el City Solicitor para asuntos legales. La supervisión operativa, la revisión de publicaciones y la administración del portal las gestiona el equipo de TI/Open Data de la ciudad; las quejas públicas pueden presentarse a través de Baltimore 311 por problemas de accesibilidad y cumplimiento, o escalarse al City Solicitor para remedios legales Department of Information Technology^[2]311^[3].

Multas monetarias o sanciones estatutarias específicamente vinculadas a la publicación de datos abiertos no están especificadas en las páginas citadas; el portal y la política de TI se centran en controles administrativos y acciones correctivas en lugar de multas enumeradas. Si un conjunto de datos o un endpoint de API viola reglas de privacidad o divulgación legales, los remedios legales y las sanciones seguirían la ley aplicable de Baltimore City o Maryland, y podrían ser manejados por el City Solicitor o la agencia reguladora pertinente.

Escalada, sanciones y apelación

• Las sanciones no monetarias pueden incluir la eliminación de conjuntos de datos publicados, la suspensión de privilegios de publicación o la restricción del acceso a la API por parte del equipo de TI de la ciudad.
• Las acciones legales o procesos judiciales los gobierna el City Solicitor cuando ocurren violaciones legales; los procedimientos y plazos exactos no están especificados en las páginas citadas.
• Las quejas y solicitudes de inspección deben enviarse vía Baltimore 311 o los canales de contacto del Departamento de TI indicados en Recursos.
• Las apelaciones o revisiones formales generalmente se manejan por vías administrativas o asesoría legal; los plazos para apelaciones no están especificados en las páginas citadas.

Infracciones comunes

• Publicar información de identificación personal sin anonimizar o sin base legal.
• Metadatos o esquemas faltantes o incorrectos que impiden la reutilización del conjunto de datos.
• Publicar datos desactualizados o inexactos que inducen a error a los usuarios.

Solicitudes y Formularios

El portal proporciona plantillas de metadatos y flujos de trabajo de envío de conjuntos de datos; no hay un formulario separado publicado de "liberación de datos abiertos" referenciado en las páginas públicas del portal. Para la publicación de conjuntos de datos, siga el proceso de envío del portal o contacte al equipo de Open Data del Departamento de TI para orientación. Los nombres específicos de formularios, números, plazos y tarifas no están especificados en las páginas citadas.

Cómo hacerlo

1. Prepare el conjunto de datos: limpie los datos, elimine identificadores personales y mapee campos a los requisitos de metadatos del portal.
2. Elija formatos: exporte archivos legibles por máquina (CSV, JSON, GeoJSON) y asegure una codificación y tipos de datos consistentes.
3. Redacte metadatos: incluya título, descripción, cadencia de actualización, contacto, licencia y diccionario de datos.
4. Publique mediante el flujo de envío del portal y configure endpoints de API o ajustes de Socrata/CKAN según corresponda.
5. Pruebe la API: verifique endpoints, parámetros de consulta y paginación; actualice límites de tasa y claves de cliente si aplica.
6. Monitoree y mantenga: programe actualizaciones, responda a comentarios de usuarios y corrija errores reportados vía 311 o puntos de contacto de TI.

FAQ

¿Cómo solicito un conjunto de datos que no está en el portal?

Envíe una solicitud de datos al Departamento de Tecnología de la Información o presente una solicitud de servicio 311 solicitando la publicación del conjunto de datos; incluya uso previsto, campos necesarios y cadencia preferida.

¿Qué formatos y licencias se aceptan?

El portal prefiere formatos abiertos y legibles por máquina como CSV, JSON y GeoJSON y fomenta licencias abiertas; consulte la guía de metadatos del portal para la selección de licencia específica.

¿Las APIs son gratuitas y tienen límites de tasa?

Las APIs son accesibles públicamente a través del portal, pero cualquier límite de tasa, claves de API o términos de uso los determina el administrador del portal y no están especificados en las páginas públicas de políticas.

Conclusiones clave

• Siga las plantillas de metadatos y esquema del portal para garantizar la publicabilidad y reutilización.
• El portal enfatiza correcciones administrativas por encima de multas monetarias; las sanciones monetarias no aparecen en las páginas de política.
• Reporte problemas de accesibilidad o cumplimiento vía Baltimore 311 o contacte al equipo de TI/Open Data.

Ayuda y Soporte / Recursos

• Portal de Datos Abiertos de Baltimore
• Departamento de Tecnología de la Información de Baltimore - Open Data
• Baltimore 311 (reportar problemas, solicitar datos)