Configuración del feed

La siguiente información te ayudará a configurar y ejecutar tus feeds correctamente.

Alojamiento de archivos de feed

El sistema de adquisición de contenido de Waze recupera automáticamente los datos de tu feed de forma periódica. Para asegurarte de que Waze recupere el archivo de feed correcto, haz lo siguiente:

  • Hazlo accesible: Usa protocolos de red estándar (HTTP, HTTPS, FTP o SFTP) o Google Cloud Storage (GCS).
  • Protege tus datos (opcional):
    • Puedes proteger tu feed con un nombre de usuario y una contraseña mediante la autenticación BÁSICA a través de HTTPS. Proporciona la combinación de acceso y contraseña a través de Partner Hub.
    • Además, admitimos integraciones de API que utilizan la autenticación basada en encabezados a través de un encabezado KeyID o OCP_APIM_SUBSCRIPTION_KEY.
    • En el caso de los archivos de GCS, puedes limitar el acceso a una cuenta de servicio que te proporcionaremos.
  • Garantiza la accesibilidad: Asegúrate de que se pueda acceder al archivo alojado de forma global.
    • Para evitar interrupciones en la recuperación de datos, asegúrate de que tu firewall no bloquee el acceso según el país, la dirección IP o la región geográfica. Estas restricciones pueden impedir que recuperemos los datos de tu feed.
    • Usamos un sistema dinámico para extraer información sobre incidentes y cierres. Esto significa que no usamos IPs estáticas ni admitimos URLs, dominios o comodines preautorizados, ni la autorización de entradas DNS.

Frecuencia del feed

El sistema de adquisición de contenido recupera datos cada pocos minutos. Si tienes requisitos especiales con respecto a la frecuencia del feed, agrega una nota que indique esta solicitud cuando envíes el feed o comunícate con el equipo de Waze para que podamos ajustar nuestros períodos de sondeo para reflejar tu ciclo de actualización del feed.

Validación de XML

Waze usa el siguiente esquema XML para definir la estructura aceptable de un feed de especificaciones de incidentes y cierres (CIFS): https://www.gstatic.com/road-incidents/cifsv2.xsd.

Existen varias herramientas disponibles en Internet que pueden ayudarte a validar la estructura de tus feeds XML. Entre ellas, se incluyen las siguientes:

Cambios críticos en el feed

Antes de realizar cualquiera de los siguientes cambios, notifica al equipo de Waze completando este formulario y editando tu solicitud en el portal para identificar el feed actualizado.

  • Modificar, agregar o quitar regiones o países de tu feed
  • Actualizar la URL del feed o cualquier credencial necesaria para acceder a la información
  • Cambiar la estructura del feed o los nombres de las etiquetas

Especificaciones del feed

Un solo archivo de feed puede proporcionar información sobre varios incidentes y cierres. Si proporcionas información sobre varios eventos, cada incidente o cierre debe detallarse en un elemento independiente y debe tener un ID único. Estas secciones deben usar la hora y la fecha locales. La especificación CIFS detalla todas las etiquetas disponibles para describir tus incidentes y cierres.