trafic.ro

Timpul mediu

Descriere | Rezultat

Această metodă întoarce o listă (max. 5 zile în urmă) cu timpul mediu exprimat in secunde petrecut de utilizatori pe site.

Nume metodă

getTimpMediu ( [string site] )

Parametrii

site string - identificatorul unic al siteului (ex: http://stat.trafic.ro/stat/okazii).

Răspuns

La apelarea metodei SOAP veţi primi drept răspuns un array de tip TimpMediuReturnArray, în care fiecare element este un obiect de tipul TimpMediuReturn.

Fiecare obiect de tip TimpMediuReturn are următoarele proprietăţi:

  • data - string
  • timp_mediu - string

Exemplu

Următorul script PHP oferă un exemplu de implementare:

<?php

/**
 * Se crează o instanţă SoapClient
 */
$sc = new SoapClient('http://'
			. 'api.trafic.ro'
			. '/soap/0.01/trafic.wsdl',
	array('soap_version' => SOAP_1_2)
	);

$site     = 'okazii';

foreach ($sc->getTimpMediu($site) as $t)
{
	/**
	 * $t este un obiect
	 * de tipul TimpMediuReturn
	 */
	echo 'data: ', $t->data,
		" | timp mediu: ", $t->timp_mediu,
		PHP_EOL;
}					

Nume metodă

timp-mediu[/identificator-site]

Parametrii

identificator-site - identificatorul unic al siteului (ex: http://stat.trafic.ro/stat/okazii).

Răspuns

Întoarce un document XML. Cu următoarele elemente:

timp-mediu
elementul rădăcină al documentului XML;
item
element ce conţine informaţiile aferente timpului mediu;
data
ziua;
timp_mediu
timpul mediu petrecut pe site exprimat in secunde;

Exemplu

Pentru a vizualiza documentul intors de această metodă accesaţi: api.trafic.ro/rest/0.01/timp-mediu/okazii

Următorul script PHP oferă un exemplu de implementare:

<?php

$siteIdentifier = 'okazii';

$address = 'http://api.trafic.ro/rest/0.01/timp-mediu/'. $siteIdentifier ;

/**
 * Se creează un obiect de tip SimpleXML
 */
$doc = simplexml_load_file($address);

/**
 * Se ciclează pe toti copii elementului 'new-vs-returning'
 */
foreach ($doc->item as $t)
{
	echo 'data: ', $t->data,
		" | timp mediu: ", $t->timp_mediu,
		PHP_EOL;
}					

Rezultat

Ambele secvenţe de cod PHP (SOAP/REST) vor afişa: