root / djnro / templates / front / api.html @ ea51bc9d
History | View | Annotate | Download (2.3 kB)
1 |
{% extends "base.html" %} |
---|---|
2 |
{% load i18n %} |
3 |
{% block currentpagetitle %}{% trans "Closest Point API" %}{% endblock %} |
4 |
{% block homepage %}{% endblock %} |
5 |
{% block hometop %}{% endblock %} |
6 |
{% block api %}active{% endblock %} |
7 |
|
8 |
|
9 |
{% block subcontent %} |
10 |
<h1>{% trans "Closest point API" %}</h1> |
11 |
<hr>
|
12 |
<div class="span6"> |
13 |
<p>{% blocktrans %}Since we collect information from eduroam.org about the available eduroam points, we developed the closest point service API, which handles locating the closest eduroam service location.{% endblocktrans %}</p> |
14 |
<p>{% blocktrans %}The API receives the current location coordinates in a GET request, calculates the closest point through server-side triangulation and returns a JSON reply with its’ coordinates and a detailed description.{% endblocktrans %}</p> |
15 |
<h5>Applications</h5> |
16 |
<p>{% blocktrans %}Based on this API, we developed the closest point web page that allows users to find the closest eduroam location or a location they search for.{% endblocktrans %}</p> |
17 |
<p>{% blocktrans %}Potentials are limitless! You can build your own application either it is web or mobile or a widget for a wearable device.{% endblocktrans %}</p> |
18 |
<h5>API</h5> |
19 |
<div class="well"> |
20 |
<strong>url: https://{{site}}{% url closest %}?lat=latitude&lng=longitude</strong><br> |
21 |
<strong>method: GET</strong><br><br> |
22 |
<strong>lat:</strong>Latitude coordinate, eg. 37.98101<br> |
23 |
<strong>lng:</strong>Longitude coordinate, eg. 23.728695 |
24 |
</div>
|
25 |
<strong>Example request: </strong> |
26 |
<div class="well"> |
27 |
Find the closest eduroam point to my position, eg. coords(37.98, 23.72): <br><strong>https://{{site}}{% url closest %}?lat=37.98&lng=23.72</strong> |
28 |
</div>
|
29 |
<strong>Example response:</strong> |
30 |
<pre>
|
31 |
{ |
32 |
"lat": "37.972883", |
33 |
"lng": "23.717463", |
34 |
"text": "\n <b>Name:</b> National Observatory, Athens, Greece<br><b>Address:</b> Athens, 118 51<br><b>SSID:</b> EDUROAM<br><b>Enc:</b> WPA2/AES<br><b>AP:</b> 1<br> \n ", |
35 |
"name": "\n <b>Name:</b> National Observatory, Athens, Greece<br><b>Address:</b> Athens, 118 51<br><b>SSID:</b> EDUROAM<br><b>Enc:</b> WPA2/AES<br><b>AP:</b> 1<br> \n " |
36 |
"plainname": "National Observatory of Athens ", |
37 |
} |
38 |
</pre>
|
39 |
</div>
|
40 |
{% endblock %} |