Web-service adresses, accès et détails

URL du web-service

https://ge.ch/teradressews_public/v1/rest/search?searchText=<recherche>&limit=<nombre>


Critères de recherche

  • searchText : chaine de caractère complète ou partielle de l'adresse,  avec ou sans le numéro de l'adresse.
  • limit : nombre d'occurrences retournées par le WS (par défaut 20).

Le flux de données récupéré est trié par pertinence descendante par rapport à la requête. La première occurrence retournée est celle qui correspond le mieux au critère.

 

Exemple

Recherche de : chemin des framboises 20, limité à 10 occurrences :

Le 20 chemin des Framboises n'existe pas, ni en Suisse ni en France, mais le web-service retourne des adresses proches.

URL : https://ge.ch/teradressews_public/v1/rest/search?searchText=chemin%20des%20framboises%202&limit=10

Démonstration

A l'aide d'une librairie tel que ci-dessous easy-autocomplete (pour jQuery), il est très facile d'implémenter un usage de base du web-service par exemple pour un champs texte.

Code source

<!DOCTYPE html>
<html lang="fr"> 
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><head>
<title>Demo WS adresse autocomplete</title>
<link rel="stylesheet" href="https://ge.ch/sitg/easy-autocomplete.min.css"> 
<script src="https://code.jquery.com/jquery-1.11.2.min.js"></script>
<script src="https://ge.ch/sitg/jquery.easy-autocomplete.min.js"></script> 
</head>
<body>

<h1>Adresses dans le Grand-Genève</h1>

<form id="myform">
<label>Recherche d'une adresse</label> <input type="text" id="myadress" style="width:400px">
</form>

<script language="javascript">
var options = {
    url: function(phrase) {
        return "https://ge.ch/teradressews_public/v1/rest/search?searchText=" + phrase;
    },
    getValue: "label"
};

$("#myadress").easyAutocomplete(options);
</script>

</body>
</html>