Traffico - Help del servizio Open Data









Help in linea del servizio di pubblicazione delle informazioni, alfanumeriche e cartografiche, relative al livello di congestione del traffico.

Questo servizio di pubblicazione è stato realizzato nell'ambito del progetto Semina.
Indice dei contenuti
Licenza Banca Dati
↑ indice
Le informazioni sul livello di congestione del traffico derivano dalla elaborazioni delle informazioni della rete e delle posizioni dei mezzi della flotta di trasporto pubblico di Amtab S.p.A., società del Comune di Bari.

La titolarità piena ed esclusiva della banca dati è di Amtab S.p.A., società del Comune di Bari (ai sensi della L. 633/41 e s.m.i.).

Amtab S.p.A., ed il Comune di Bari, autorizzano la libera e gratuita consultazione, estrazione, riproduzione e modifica dei dati in essa contenuti da parte di chiunque vi abbia interesse per qualunque fine, ovvero secondo i termini della Licenza Creative Commons - CC0 1.0 Universal

Questa licenza è coerente con le linee guida del Comune di Bari sugli OpenData
Informazioni sui dati (metadati)
↑ indice
Nome Valore
Autore Amtab S.p.A.
Manutentore Amtab S.p.A.
Data di creazione del servizio 01/04/2015
Data ultima modifica del dato Dati dinamici soggetti a variazione continua
Data ultima modifica del metadato 15/06/2015
Tipo di dato Alfanumerico/Cartografico
Versione 1.0
Servizi cartografici
↑ indice
Le informazioni relative al livello del traffico sono pubblicate in modalit cartografica mediante lo standard OGC WMS e WFS.

Le informazioni pubblicate mediante standard OGS sono relativi:

La descrizione del servizio WMS è consultabile con la richiesta GetCapabilities dello standard OGC WMS:
La descrizione del servizio WMS è consultabile con la richiesta GetCapabilities dello standard OGC WFS:


Strade di Bari interessate dalla rete di trasporto pubblico locale (TPL) dell’Amtab SPA
In questo servizio cartografico non sono fornite informazioni sul traffico ed utile per avere, mediante GetFeature del WFS, le strade su cui vengono effettuate le elaborazioni.
Ogni tratto di strada, in cui segmentato il reticolo, è caratterizzato dall’identificativo idShapeFile

Il nome del layer è:
versione_ReteAmtab

Dove la versione nella forma: Traffico.vX.Y

Di seguito un esempio di richiesta GetMap dello standard OGC WMS con relativa immagine restituita:


Strade di Bari interessate dalla rete di trasporto pubblico locale (TPL) dell’Amtab SPA con traffico associato
In questo servizio cartografico sono fornite informazioni sul livello di congestione del traffico.
Da notare che per uno stesso tratto di strada ci possono essere due feature, caratterizzate dallo stesso valore di identificativo idShapeFile, al fine di considerare il livello di traffico nelle due sensi di marcia.

Anche in caso il servizio cartografico pu essere interrogato mediante GetFeature del WFS per avere la definizione i tratti di strada con il relativo livello di traffico

L’altro scopo di questo layer di fornire la legenda della tematizzazione delle strade in base al livello di traffico mediante GetLegendGraphic del WMS.

Il nome del layer è:
versione_ReteAmtabTraffico

Dove la versione nella forma: Traffico.vX.Y

Il campi presenti sono:
  • idShapeFile: identificativo del segmento di strada
  • versoAttraversamento: verso di attraversamento del segmento che assume i seguenti valori:
    • CONCORDE: quando il segmento attraversato dal mezzo nel senso di digitalizzazione del segmento, ossia dall’estremo FromPoint all’estremo ToPoint
    • DISCORDE: quando il segmento attraversato dal mezzo nel senso discorde, ossia dall’estremo ToPoint all’estremo FromPoint
  • valoreIndiceTempoPercorrenza: valore dell’indice di traffico relativo al tempo di attraversamento, assume i seguenti valori:
    • 0: assenza di informazioni
    • 1: veloce
    • 2: scorrevole
    • 3: rallentato
    • 4: lento
  • tipoCalcoloIndiceTempoPercorrenza: tipo di calcolo:
    • 0: assenza di informazioni
    • 1: valore indice basato su storico (non utilizzato)
    • 2: valore indice basato su realtime
  • timestampAggiornamento: data di aggiornamento dello stato del traffico nel formato yyyy-mm-ddThh:mi:ss in UTC (ad esempio: 2015-06-26T11:21:38)
  • minutiUltimoAggiornamento: minuti dall'ultimo aggiornamento dello stato del traffico

Di seguito un esempio di richiesta GetMap dello standard OGC WMS con relativa immagine restituita:
Di seguito la richiesta GetLegendGraphic dello standard OGC WMS per la visualizzazione della legenda del servizio cartografico con relativa immagine restituita:
Di seguito un esempio di richiesta GetFeature dello standard OGC WFS per recuperare le features che fanno parte del layer con le relative informazioni alfanumeriche:
http://maps.semina.planetek.it/geoserver/traffico.v1.0/wfs?service=wfs&version=1.1.0&request=GetFeature&typename=Traffico.v1.0_ReteAmtabTraffico&maxFeatures=10

Da notare la presenza del parametro maxFeatures=10 che limita il numero di elementi restituiti dal servizio.

Di seguito un estratto dell’XML restituito relativo ad una singola feature:

<traffico.v1.0:Traffico.v1.0_ReteAmtabTraffico gml:id="Traffico.v1.0_ReteAmtabTraffico.fid-188ce818_14e2f993893_-4a8">
   <traffico.v1.0:idShapeFile>14</traffico.v1.0:idShapeFile>
   <traffico.v1.0:versoAttraversamento>CONCORDE</traffico.v1.0:versoAttraversamento>
   <traffico.v1.0:the_geom>
      <gml:MultiCurve srsDimension="2" srsName="urn:x-ogc:def:crs:EPSG:4326">
         <gml:curveMember>
            <gml:LineString srsDimension="2">
               <gml:posList>
                  41.1248047710786 16.8158908591543 41.1252405669211 16.8168585219852
               </gml:posList>
            </gml:LineString>
         </gml:curveMember>
      </gml:MultiCurve>
   </traffico.v1.0:the_geom>
   <traffico.v1.0:valoreIndiceTempoPercorrenza>2</traffico.v1.0:valoreIndiceTempoPercorrenza>
   <traffico.v1.0:tipoCalcoloIndiceTempoPercorrenza>2</traffico.v1.0:tipoCalcoloIndiceTempoPercorrenza>
   <traffico.v1.0:timestampAggiornamento>2015-06-26T11:23:37</traffico.v1.0:timestampAggiornamento>
   <traffico.v1.0:minutiUltimoAggiornamento>1</traffico.v1.0:minutiUltimoAggiornamento>
   <traffico.v1.0:lastUpdateRete>2014-01-10T23:00:00Z</traffico.v1.0:lastUpdateRete>
</traffico.v1.0:Traffico.v1.0_ReteAmtabTraffico>




Strade di Bari con rappresentazione della carreggiata interessate dalla rete di trasporto pubblico locale (TPL) dell’Amtab SPA con traffico associato
In questo servizio cartografico sono fornite informazioni sul livello di congestione del traffico.
Questo servizio cartografico finalizzato alla sola rappresentazione cartografica del fato in quanto lo stato del traffico stato spazialmente splittato per le carreggiate della strada.

Anche in caso il servizio cartografico pu essere interrogato mediante GetFeature del WFS per avere la definizione i tratti di strada con il relativo livello di traffico

Il nome del layer è:
versione_ReteAmtabTrafficoCarreggiata

Dove la versione nella forma: Traffico.vX.Y

Il campi presenti sono gli stessi del precedente servizio, cambia solo la resa grafica cos come è possibile notare dalla immagine restituita da una richiesta GetMap a questo layer (prima immagine) rispetto al precedente layer (seconda immagine).


Servizio alfanumerico REST
↑ indice
Il servizio REST è destinato agli utenti Web che hanno necessità di richiamare il servizio via HTTP GET, ad es. da un browser o uno smatphone.

Il formato di presentazione dei dati è JSON.

La guida tecnica di tutti i servizi REST è consultabile seguendo questo link


I metodi esposti dal servizio sono descritti nei paragrafi successivi.

Data ultimo aggiornamento
Il metodo restituisce l’orario dell’ultimo aggiornamento dello stato del livello del traffico.

La firma del metodo è:
.../REST/dataUltimoAggiornamento/?timeZone={TIMEZONE}

con il parametro TIMEZONE è possibile decidere in che timeZone ottenere gli orari, e assumere i seguenti valori:
  • UTC
  • IT (default)
Di seguito alcuni esempi su come utilizzare il servizio REST:
#Esempio di utilizzo del metodo Data ultimo aggiornamento mediante chiamata HTTP GET con restituzione degli orari in UTC (default)
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/dataUltimoAggiornamento
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/dataUltimoAggiornamento/?timeZone=UTC

#Esempio di utilizzo del metodo Data ultimo aggiornamento mediante chiamata HTTP GET con restituzione degli orari in locale italiano
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/dataUltimoAggiornamento/?timeZone=IT

La descrizione tecnica del metodo si trova nel paragrafo si può consultare la guida tecnica.

Strade monitorate
Il metodo restituisce l’elenco delle strade per le quali abilitato il servizio di pubblicazione, come opendata, del livello del traffico.

La firma del metodo è:
.../REST/poi/?ascDesc={ASCDESC}

con il parametro ASCDESC è possibile decidere l’elenco delle strade presentato in ordine crescente o descrescente, e assumere i seguenti valori:
  • ASC (default)
  • DESC
Di seguito alcuni esempi su come utilizzare il servizio REST:
#Esempio di utilizzo del metodo Strade monitorate mediante chiamata HTTP GET con restituzione della lista delle strade in ordine crescente (default):
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/poi
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/poi/?ascDesc=ASC

#Esempio di utilizzo del metodo Data ultimo aggiornamento mediante chiamata HTTP GET con restituzione della lista delle strade in ordine decrescente
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/poi/?ascDesc=DESC

La descrizione tecnica del metodo si trova nel paragrafo si può consultare la guida tecnica.

Stato traffico sulle strade monitorate
Il metodo restituisce lo stato del livello di congestione del traffico per le strade per le quali abilitato il servizio di pubblicazione, come opendata, del livello del traffico.

La firma del metodo è:
.../REST/statoPoi/?timeZone={TIMEZONE}&orderBy={ORDERBY}&ascDesc={ASCDESC}

con il parametro TIMEZONE è possibile decidere in che timeZone ottenere gli orari, e assumere i seguenti valori:
  • UTC
  • IT (deafult)

con il parametro ORDERBY è possibile decidere in base a quale attributo ordinare la lista restituita, e assumere i seguenti valori:
  • STATOTRAFFICO (default)
  • NOMESTRADA

con il parametro ASCDESC, che lavora in coppia con il precedente, è possibile decidere se l'ordinamento deve essere crescente o descrescente, e assumere i seguenti valori:
  • ASC (deafult)
  • DESC
Di seguito alcuni esempi su come utilizzare il servizio REST:
#Esempio di utilizzo del metodo Strade monitorate mediante chiamata HTTP GET con restituzione della lista delle strade in ordine crescente:
http://bari.opendata.planetek.it/traffico/v1.0/TrafficService.svc/REST/statoPoi/?ascDesc=ASC&orderBy=STATOTRAFFICO&timeZone=UTC
Di seguito viene presentato un esemio di items ottenuto come output della precedente richiesta:
{
   "NumTransiti": 1,
   "Poi": {
      "Codice": "NAPOLI_002",
      "Descrizione": "Via Napoli, da Via di Maratona direzione Via Brigata Regina",
      "Latitudine": 41.1247482299805,
      "Longitudine": 16.7791538238525
   },
   "Timestamp": {
      "TimestampAggiornamentoTraffico": "2015-05-18T15.06.03Z",
      "TimestampRichiesta": "2015-05-18T15.07.07Z"
   },
   "ValoreIndiceTempoPercorrenza": 0
}
È da notare che l’attributo ValoreIndiceTempoPercorrenza è quello che contiene il valore dello stato del livello di traffico secondo i seguenti valori:
  • 0: assenza dati
  • 1: veloce
  • 2: scorrevole
  • 3: rallendato
  • 4: lento


La descrizione tecnica del metodo si trova nel paragrafo si può consultare la guida tecnica.

Contatti e informazioni
↑ indice
Per maggiori informazioni sul servizio contattare urp @ amtab . it

Per informazioni tenciche contattare semina @ planetek . it