Locations v1 / Străzi

Adresele (numerele) unei străzi

Punctele de adresă ale străzii (număr + coordonată + cod poștal), din OSM, paginate.

GET

https://oneapi.ro/api/locations/v1/strazi/{id}/adrese

Parametri de cale

NumeTipDescriereExemplu

idobligatoriu string Identificatorul intern al străzii — se obţine din căutarea de străzi.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Punctele de adresă din OSM (număr + coordonată), paginate.

La ce folosește

Plasarea numerelor stradale ca marcaje pe hartă pentru o stradă.
Găsirea codului poștal al unui număr concret dintr-o stradă.
Confirmarea că un număr există pe stradă la validarea adresei de livrare.

Structura răspunsului

CâmpTipDescriere

data[].numar string Numărul poștal, ca text (poate conține sufix, ex. 12A).

data[].cod_postal string | null Codul poștal al punctului; null când OSM nu îl are.

data[].lat number Latitudinea punctului de adresă (OSM).

data[].lng number Longitudinea punctului de adresă (OSM).

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/strazi/16416/adrese?per_pagina=20

{
    "data": [
        {
            "numar": "2",
            "cod_postal": "400487",
            "lat": 46.75725404999999,
            "lng": 23.5865691
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 4,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/216508/adrese

{
    "data": [
        {
            "numar": "2",
            "cod_postal": null,
            "lat": 44.4758653,
            "lng": 26.0466588
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 176,
            "pagini": 9
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/16416/adrese?per_pagina=5

{
    "data": [
        {
            "numar": "2",
            "cod_postal": "400487",
            "lat": 46.75725404999999,
            "lng": 23.5865691
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 5,
            "total": 4,
            "pagini": 1
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Strada nu există.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "Strada nu există."
    }
}