Configura il feed

Le informazioni che seguono ti aiuteranno a configurare e utilizzare correttamente i feed.

File hosting del feed

Il sistema di acquisizione dei contenuti di Waze recupera automaticamente i dati del feed periodicamente. Per assicurarti che Waze recuperi il file del feed corretto:

  • Rendi il file accessibile: utilizza protocolli di rete standard (HTTP, HTTPS, FTP o SFTP) o Google Cloud Storage (GCS).
  • Proteggi i dati (facoltativo):
    • Puoi proteggere il feed con un nome utente e una password utilizzando l'autenticazione BASIC tramite HTTPS. Fornisci la combinazione di nome utente e password tramite Partner Hub.
    • Inoltre, supportiamo le integrazioni API che utilizzano l'autenticazione basata su intestazione tramite un'intestazione KeyID o Ocp-Apim-Subscription-Key.
    • Per i file GCS, puoi limitare l'accesso a un account di servizio che ti forniremo.
  • Garantisci l'accessibilità: assicurati che il file ospitato sia accessibile a livello globale.
    • Per evitare interruzioni nel recupero dei dati, assicurati che il firewall non blocchi l'accesso in base a paese, indirizzo IP o regione geografica. Queste restrizioni potrebbero impedirci di recuperare i dati del feed.
    • Utilizziamo un sistema dinamico per recuperare le informazioni su chiusure e incidenti. Ciò significa che non utilizziamo IP statici né supportiamo l'autorizzazione di URL/domini/caratteri jolly preautorizzati o l'autorizzazione delle voci DNS.

Frequenza del feed

Il sistema di acquisizione dei contenuti recupera i dati ogni pochi minuti. Se hai requisiti speciali in merito alla frequenza del feed, aggiungi una nota che indichi questa richiesta quando invii il feed o contatta il team di Waze in modo che possiamo modificare i periodi di polling in base al ciclo di aggiornamento del feed.

Convalida XML

Waze utilizza il seguente schema XML per definire la struttura accettabile di un feed delle specifiche di chiusura e incidenti (CIFS): https://www.gstatic.com/road-incidents/cifsv2.xsd.

Su internet sono disponibili diversi strumenti che possono aiutarti a convalidare la struttura dei feed XML. Questi includono, a titolo esemplificativo:

Modifiche critiche al feed

Prima di apportare una delle seguenti modifiche, notifica il team di Waze compilando questo modulo e modificando la richiesta nel Portale per identificare il feed aggiornato.

  • Modifica, aggiunta o rimozione di regioni o paesi dal feed.
  • Aggiornamento dell'URL del feed o di eventuali credenziali necessarie per accedere alle informazioni.
  • Modifica della struttura del feed o dei nomi dei tag.

Specifiche del feed

Un singolo file del feed può fornire informazioni su più chiusure e incidenti. Se fornisci informazioni su più eventi, ogni chiusura o incidente deve essere descritto in un elemento separato e deve avere un ID univoco. Queste sezioni devono utilizzare l'ora e la data locali. La specifica CIFS descrive in dettaglio tutti i tag disponibili per descrivere incidenti e chiusure.