Configurazione del feed
Le seguenti informazioni ti aiuteranno a configurare e pubblicare correttamente i tuoi feed.
Hosting del file 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:
- Rendili accessibili:utilizza protocolli di rete standard (HTTP, HTTPS, FTP o SFTP).
- Proteggi i tuoi dati (facoltativo): puoi proteggere il tuo feed con un nome utente e una password utilizzando l'autenticazione di base tramite HTTPS. Fornisci la combinazione di nome utente e password tramite Partner Hub.
- Garantire 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 limitazioni potrebbero impedirci di recuperare i dati del tuo feed.
- Utilizziamo un sistema dinamico per estrarre le informazioni relative alla chiusura e agli incidenti. Ciò significa che non utilizziamo IP statici né supportiamo URL/domini/caratteri jolly preautorizzati o l'autorizzazione delle voci DNS.
Frequenza di aggiornamento 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 al momento dell'invio del feed oppure contatta il team di Waze per consentirci di modificare i periodi di polling in base al ciclo di aggiornamento del feed.
Convalida XML
Waze utilizza lo schema XML seguente per definire la struttura accettabile di un feed CIFS (Closure and Incidents Feed Specifications): https://www.gstatic.com/road-incidents/cifsv2.xsd.
Su internet sono disponibili diversi strumenti che possono aiutarti a convalidare la struttura dei tuoi feed XML. Sono inclusi, a titolo esemplificativo:
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
Modifiche importanti al feed
Prima di apportare una delle seguenti modifiche, informa il team di Waze compilando questo modulo e modificando la richiesta nel portale per identificare il feed aggiornato.
- Modificare, aggiungere o rimuovere 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 la data e l'ora locali. La specifica CIFS elenca tutti i tag disponibili per descrivere gli incidenti e le chiusure.