Utiliser Devolia Geo

De Devolia.org wiki - FR.

Sommaire 1 Utiliser Devolia Geo 1.1 Actions 1.1.1 get_closest_city 1.1.2 get_city_from_ip 2 Problèmes et améliorations 3 API Javascript

Utiliser Devolia Geo

Depuis la version 1.1, Devolia Geo est distribué avec une interface utilisateur qui vous permet de tester si votre installation est correcte.

En considérant que votre copie de Devolia Geo est installée sur http://www.yourserver.com/geo/, le service peut être atteint sur http://www.yourserver.com/geo/geoservice-rpc.php. L'interface de test est disponible sur http://www.yourserver.com/geo/

Actions

• Pour commander une action, utilisez geoservice-rpc.php?action={your_action}
• get_closest_city retourne la ville / pays le plus proche
• get_closest_city_weather retourne la ville / pays le plus proche, connu par Weather.com
• get_city_from_ip retourne la ville / pays le plus proche ainsi que les coordonnées GPS, à partir d'une adresse IP

get_closest_city

• Commandé par geoservice-rpc.php?action=get_closest_city
• Les paramètres sont long (longitude, float) lat (latitude, float) et mode (mode de retour, xml ou json)
• Sans paramètre, get_closest_city renvoie Paris, France (capitale mondiale du glamour) au format xml.

• Exemple #1

http://www.yourserver.com/geo/geoservice-rpc.php

doit renvoyer

<data>
  <city>Paris</city>
  <country>France</country>
  <exec_time>0.10 seconds</exec_time>
</data>

• Exemple #2

http://www.yourserver.com/geo/geoservice-rpc.php?mode=json

doit renvoyer

{"city":"Paris","country":"France","exec_time":"0.10 seconds"}

• Exemple #3

http://www.yourserver.com/geo/geoservice-rpc.php?action=get_closest_city&lat=40.714269&long=-74.005973

doit renvoyer

<data>
  <city>New York City</city>
  <country>United States</country>
  <exec_time>0.10 seconds</exec_time>
</data>

get_city_from_ip

• Commandé par geoservice-rpc.php?action=get_city_from_ip
• Les paramètres sont ip (facultatif) et mode (mode de retour, xml ou json)
• Sans paramètre, get_closest_city géolocalise l'IP du client et envoie le retour au format xml.

• Exemple #1

http://www.yourserver.com/geo/geoservice-rpc.php?action=get_city_from_ip&ip=209.85.227.147&mode=json

doit renvoyer

{"city":"Mountain View","country":"United States","latitude":"37.4192","longitude":"-122.057","exec_time":"0.96 seconds"}

• Exemple #2

http://www.yourserver.com/geo/geoservice-rpc.php?action=get_city_from_ip&ip=193.227.146.10

doit renvoyer

<data>
  <city>Frankfurt Am Main</city>
  <country>Germany</country>
  <latitude>50.1167</latitude>
  <longitude>8.6833</longitude>
  <exec_time>0.72 seconds</exec_time>
</data>

Problèmes et améliorations

Consultez notre guide pour nous rapporter un bug ou suggérer une amélioration.

API Javascript

Depuis la version 1.4.0, Devolia Geo est également livré avec une API Javascript