Configura il feed

Le seguenti informazioni ti aiuteranno a configurare e gestire correttamente i feed.

Hosting di 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:

  • Rendilo accessibile:utilizza protocolli di rete standard (HTTP, HTTPS, FTP o SFTP) o Google Cloud Storage (GCS).
  • (Facoltativo) Proteggi i tuoi dati:
    • Puoi proteggere il feed con un nome utente e una password utilizzando l'autenticazione BASIC su HTTPS. Fornisci la combinazione di accesso 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 service account che ti forniremo.
  • 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 al paese, all'indirizzo IP o alla regione geografica. Queste limitazioni potrebbero impedirci di recuperare i dati del feed.
    • Utilizziamo un sistema dinamico per estrarre le informazioni su chiusure e incidenti. Ciò significa che non utilizziamo IP statici e non supportiamo l'autorizzazione di URL/domini/caratteri jolly preautorizzati o di voci DNS.

Frequenza di caricamento 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 nostri periodi di polling per riflettere il 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 tuoi feed XML. Questi includono, a titolo esemplificativo:

Modifiche critiche ai feed

Prima di apportare una delle seguenti modifiche, comunica al team di Waze di aver completato questo modulo e modifica la richiesta nel Producer Portal 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 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 descrive in dettaglio tutti i tag disponibili per descrivere i tuoi incidenti e le chiusure.