Salt la conținutul principal
Orice anunț are un loc precis pe hartă. Căutarea pe Housera pornește de la hartă, deci coordonatele sunt la fel de importante ca prețul.

​
Câmpurile

​
number
obligatoriu
Latitudinea punctului, între -90 și 90. Exemplu: 47.1752.
​
number
obligatoriu
Longitudinea punctului, între -180 și 180. Exemplu: 27.5701.
​
string
obligatoriu
Localitatea (orașul, comuna sau satul). Exemplu: Iași, Miroslava, București.
​
string
obligatoriu
Numele străzii, cu tot cu tipul ei: Strada Vasile Lupu, Bulevardul Lascăr Catargiu. Dacă proprietatea e pe un drum fără nume, trimite denumirea locală folosită (de exemplu Drumul Comunal 12).
​
string
Numărul, ca text: 12, 7A, Bl. C3. Opțional, pentru că multe străzi rurale nu au numerotare.
​
string
Județul: Iași, Cluj, București. Diacriticele sunt opționale. Recomandat: fără județ, Housera nu poate potrivi localitatea cu registrul de locuri (vezi mai jos).
​
string
Cartierul sau zona: Copou, Tătărași, Piața Victoriei.
​
string
Codul ISO 3166-1 alpha-2 al țării, de exemplu RO. Literele mici sunt acceptate și transformate în majuscule.
​
string
Un reper apropiat, de cel mult 120 de caractere, afișat după adresă: lângă Palas Mall.

​
Coordonatele sunt sursa de adevăr

Punctul (latitude, longitude) e cel care apare pe hartă și după care anunțul e găsit în căutare. Trimite punctul proprietății, nu centrul orașului:
  • dacă sistemul tău are coordonatele din geocodarea adresei, folosește-le;
  • dacă nu le are, geocodează adresa completă (stradă, număr, localitate, județ) înainte de trimitere;
  • verifică ordinea: în JSON, latitude e cea de aproximativ 44–48 pentru România, iar longitude cea de aproximativ 20–30.
O greșeală frecventă e inversarea latitudinii cu longitudinea. Rezultatul e un anunț pus în alt colț al lumii, pe care nimeni nu-l găsește în căutare. Regulile verifică doar intervalele valide, nu și că punctul e în localitatea trimisă.

​
Normalizarea prin registrul de locuri

Housera are un registru al localităților și cartierelor. Când trimiți județul, localitatea și zona, numele lor sunt aduse la ortografia din registru: Așa, anunțurile tale apar corect la căutarea după oraș sau cartier, oricum ar fi scrise în sistemul tău. Un nume pe care registrul nu-l cunoaște nu e refuzat: se păstrează exact cum l-ai trimis. Nu trebuie să rezolvi tu locul înainte: trimiți textul pe care îl ai, iar Housera face potrivirea. Pentru potrivire are nevoie de județ, deci trimite-l de fiecare dată. În răspuns, locația arată așa:
county vine ca identificator scurt, fără diacritice (iasi, cluj, bucuresti), iar city și area ca nume.

​
Precizia

Câmpul location.precision poate fi exact sau approximate. Anunțurile publicate prin API au întotdeauna locația exactă, așa cum ai trimis-o, ca cele adăugate din formular.