> ## Documentation Index
> Fetch the complete documentation index at: https://api.housera.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Locația

> Coordonatele, orașul și strada unui anunț, și cum le normalizează Housera.

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

<ParamField body="latitude" type="number" required>
  Latitudinea punctului, între -90 și 90. Exemplu: `47.1752`.
</ParamField>

<ParamField body="longitude" type="number" required>
  Longitudinea punctului, între -180 și 180. Exemplu: `27.5701`.
</ParamField>

<ParamField body="city" type="string" required>
  Localitatea (orașul, comuna sau satul). Exemplu: `Iași`, `Miroslava`, `București`.
</ParamField>

<ParamField body="street" type="string" required>
  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`).
</ParamField>

<ParamField body="street_number" type="string">
  Numărul, ca text: `12`, `7A`, `Bl. C3`. Opțional, pentru că multe străzi rurale nu au numerotare.
</ParamField>

<ParamField body="county" type="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).
</ParamField>

<ParamField body="area" type="string">
  Cartierul sau zona: `Copou`, `Tătărași`, `Piața Victoriei`.
</ParamField>

<ParamField body="country" type="string">
  Codul ISO 3166-1 alpha-2 al țării, de exemplu `RO`. Literele mici sunt acceptate și transformate în majuscule.
</ParamField>

<ParamField body="landmark" type="string">
  Un reper apropiat, de cel mult 120 de caractere, afișat după adresă: `lângă Palas Mall`.
</ParamField>

## 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.

<Warning>
  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ă.
</Warning>

## 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:

| Trimiți | Se salvează |
| - | - |
| `"county": "IASI", "city": "iasi"` | județul Iași, orașul `Iași` |
| `"county": "Iasi", "city": "Iasi", "area": "copou"` | orașul `Iași`, zona `Copou` |

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:

```json theme={null}
"location": {
  "country": "RO",
  "county": "iasi",
  "city": "Iași",
  "area": "Copou",
  "lat": 47.1752,
  "lng": 27.5701,
  "precision": "exact"
}
```

`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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.