Yahoo Placemaker: geolocalizzare i contenuti di una pagina Web

Grazie ad un nuovo Webservice di Yahoo, Yahoo Placemaker, è possibile estrarre informazioni (la georeferenziazione) di qualsiasi località citata all’interno di una pagina Web, RSS o anche documento di testo.
Come sempre un esempio vale più di mille parole.
Per utilizzare il webservice è necessario richiamare l’indirizzo Web http://wherein.yahooapis.com inviando tramite POST quattro parametri:

  • l’indirizzo della risorsa (URI) di cui si vuole geolocalizzare i contenuti, ad esempio https://robertoscano.info
  • il tipo di documento che può essere text/plain, text/html, text/xml, text/rss, application/xml oppure application/xml+rss
  • il formato di documento che si desidera come output (XML o RSS)
  • la Yahoo Application ID

Tramite PHP possiamo usare curl nel seguente modo:

<?php
$key = 'CHIAVE_API_DI_YAHOO';
$apiendpoint = 'http://wherein.yahooapis.com/v1/document';
$url = 'https://robertoscano.info';
$inputType = 'text/html';
$outputType = 'xml';
$post = 'appid='.$key.'&documentURL='.$url.
'&documentType='.$inputType.'&outputType='.$outputType;
$ch = curl_init($apiendpoint);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$results = curl_exec($ch);
header('content-type:text/xml');
echo $results;
?>

Per chi vuole approfondire meglio l’estrazione dei contenuti segnalo l’ottimo articolo di Chris Heilmann.