Reverse

versiunea 11, actualizată de aurelian în 22 Jul, 2009

Privire de ansamblu

/api/reverse ofera o lista de locatii aflate in apropierea unui punct cunoscut prin latitudine/longitudine.

Apel

GET /api/reverse

Parametrii:

parametru descriere valore posibilă valoare implicită
latitude latitudinea float –
longitude latitudinea float –
api_key cheia de acces string –
radius raza maxima de cautare in kilometrii [0,5] 2
format formatul răspunsului xml, json sau georss xml
page pagina int 1
version versiunea dorită 0.5 0.5
callback javascript callback numele unei functii javascript ce va fi apelată având ca parametru raspunsul. (functionează doar pentru format=json) –

Nota

  • detalii specifice pentru georss

Exemple

http://ondi.ro/api/reverse?api_key=[KEY]&latitude=44.44&longitude=26.1&radius=1.5

http://ondi.ro/api/reverse?api_key=[KEY]&latitude=45.29&longitude=26.67&format=json

Răspuns

Raspunsul este similar cu /api/locate conținând două secțiuni: header și places.

  1. header oferă informații generice despre serviciu, și conține:
    • code, codul de răspuns: 10 OK, 20-29 WARNING, 30-39 ERROR
    • results, numărul de rezultate găsite
    • version, versiunea folosită (0.3)
    • service, metoda apelata si parametrii primiti
    • page, pagina curenta
    • per_page, numarul de rezultate pe pagina
    • pages, numarul total de pagini
  2. places este o listă de place, fiecare conținând:
    • name, numele locației (format: tip nume)
    • parent, numele locației părinte
    • county, județul
    • kind, tipul locației
    • updated, data ultimei actualizări
    • distance, distanta in kilometrii fata de centrul specificat
    • latitude
    • longitude

kind: valori posibile:

kind ce înseamnă?
4 Municipiu reședință de județ
16 Municipiu
32 Oraș
64 Cartier
256 Localitate reședință de comună
512 Localitate
2048 Generic: Punct de interes neutilizat
2050 Club, Bar, Pub, Berarie
2052 Restaurant

code: valori posibile:

code semnificație
10 OK
21 Warning: ApiKey-ul folosit nu poate fi validat
31 Error: ApiKey invalid
32 Error: Versiune Invalidă
33 Error: ApiKey dezactivat
34 Error: Raza specificata este mai mare decat cea permisa
36 Error: Punctul specificat nu se afla in Romania
37 Error: Limita accesari / zi a fost atinsa
38 Error: Contul necesita revalidare