Wikiloc : l'article wikipedia sur votre mobile sfr le plus proche de l'endroit ou vous êtes par un simple sms via sfr api

Commenter

Contenu du snippet

WikiLoc permet de recevoir l'article Wikipedia le plus pertinent proche de l'endroit ou vous vous situez. Il suffit d'envoyer depuis une ligne SFR, le SMS : "#wikiloc# wiki" au 6010 (numéro gratuit). Vous recevez dans les 5 minutes, la réponse par SMS sous forme d'un lien cliquable. Ce service ne fonctionne qu'avec des lignes SFR.
il est également possible d'obtenir un numéro court gratuit pour ne plus avoir besoin du #wikiloc# en envoyant "#wikiloc# short" au 6010 (en général le numéro proposé sera le 1812).

Les requêtes ont été construites via l'API Test Tool de SFR API. Il est conseiller de s'inscrire pour utiliser votre propre identifiant plutôt que l'identifiant de l'exemple dont le compteur de crédits peut être épuisé.

Le code PHP, doit être appelé automatiquement a fréquence régulière via un cron afin d'analyser la file des SMS entrants. Dans notre exemple, ce code est hébergé chez free et régulièrement appelé par cronjobonline.

Source / Exemple : 


<?php

//TOKEN généré à titre de demonstration par SFR
//le nombre de SMS disponibles sur ce compte peut être épuisé
//il est conseiller de vous inscrire sur api.sfr.fr pour obtenir votre propre token
define("DEVTOKEN","81e3d203dd52a852fa986624c718929c");

// RestRequest est une fonction générique pour exécuter des requêtes REST en PHP 
// cette fonction utilise fopen. Elle est compatible avec l'hébergement gratuit chez Free.
function RestRequest ($url, $method='GET', $data=null, $optional_headers = null) {
  $params = array('http' => 
  				array('method'=>$method, 
  					  'content'=>$data,
  						'timeout'=>20
  				));
  			 				
  if ($optional_headers !== null) {$params['http']['header'] = $optional_headers;}
 
  $ctx = stream_context_create($params);
  $fp = @fopen($url, 'rb', false, $ctx);
 
  if (!$fp) {
  	//throw new Exception("Problem with $url, $php_errormsg");
  	echo("Requete en echec\n");
  	return(null);
  }
  $response = @stream_get_contents($fp);
 
  if ($response === false) {throw new Exception("Problem reading data from $url, $php_errormsg");}
 
  return $response;
}
	

	//Le code principale est appellé régulièrement via un cron
	//Sur cronjobonline il est possible de mettre en place  
	//gratuitement un appel régulier pour une page php.
	
	//Via la méthode Consume on interroge la file des SMS entrants
	//cette méthode à été construite via l'API Test Tool d'SFR API : api.sfr.fr/apitesttool
	$event=simplexml_load_string(RestRequest("http://ws.red.sfr.fr/red-ws/red-b2c/resources/event/consume?responseType=xml&token=".DEVTOKEN));
	if($event->redEvent->eventCode==11)
	{	
		//On récupére le numéro de l'expéditeur
		$exp=$event->redEvent->eventSource;

		//Si le message est "wiki"...	
		if(strtolower($event->redEvent->eventMessage)=="wiki"){

			//... On géolocalise la ligne émetrice
			//la première fois il faut qu'elle confirme qu'elle accepte d'être géolocalisée par WikiLoc
			//si elle confirme la localization peut être réalisée
			$url="http://ws.red.sfr.fr/red-ws/red-b2c/resources/loc/localize?responseType=xml&token=".DEVTOKEN.
				"&userIdentifier=".$exp."&type=PhoneNumber";
			$rc=simplexml_load_string(RestRequest($url));
			
			//Si la localisation a pu être réalisée errorcode=0 ... 
			if(($rc)&&($rc->errorCode==0)){
				$lng=$rc->location->longitude;
				$lat=$rc->location->latitude;
				
				//... On interroge le service geoname pour récupéré les articles wikipedia les plus proches
				//Le service est interogé avec le username "sfrapi", il est conseiller de vous inscrire
				//afin d'utiliser votre propre compte
				$xml=simplexml_load_string(RestRequest("http://api.geonames.org/findNearbyWikipedia?lat=".$lat."&lng=".$lng."&username=sfrapi&style=full"));	
				if($xml)
					//puis on recherche l'article le plus pertinent dans la liste des articles
					//retournés par geoname
					for($i=0;$i<count($xml->entry);$i++){
						$article=$xml->entry[$i];
						if($article->rank>$max){$max=$article->rank;$best=$article;}
					}
				
				//Enfin le lien vers l'article le plus pertinent est renvoyé via SMS au demandeur.
				RestRequest("http://ws.red.sfr.fr/red-ws/red-b2c/resources/sms/send?responseType=xml&token=".DEVTOKEN."&to=".$exp."&type=PhoneNumber&msg=".$best->wikipediaUrl);
			}		
		}

		//Si le message est "short" on affecte un numéro court à l'expéditeur qui
		//pourra être utilisé pour éviter l'usage du 6010 avec l'alias #wikiloc#
		if(strtolower($event->redEvent->eventMessage)=="short"){
			$xml=simplexml_load_string(RestRequest("http://ws.red.sfr.fr/red-ws/red-b2c/resources/shortcode/generateSmsShortcode?responseType=json&token=".DEVTOKEN."&msisdn=".$exp));
			if($xml->errorCode==0)
				RestRequest("http://ws.red.sfr.fr/red-ws/red-b2c/resources/sms/send?responseType=xml&token=".DEVTOKEN."&to=".$exp."&type=PhoneNumber&msg=utilisez%20ce%20numero%20pour%20interroger%20wikiloc%20en%repondant%20wiki");		
		}	
	}	
?>

Conclusion :


Cet exemple utilise les API de géolocalisation, d'envoi et de réception des SMS. D'autres API sont disponibles sur SFR API : envoyer des photos, vidéo, son via MMS, gérer le carnet de contacts, identifier les modèles de mobile, ...

Hervé Hoareau
Responsable SFR API
S'inscrire maintenant

Vous n'êtes pas encore membre ?

inscrivez-vous, c'est gratuit et ça prend moins d'une minute !

Les membres obtiennent plus de réponses que les utilisateurs anonymes.

Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.

Le fait d'être membre vous permet d'avoir des options supplémentaires.

Du même auteur (hhoareau)