oneapi
Autentificare
Locations v1 / Străzi

Detaliu stradă

O stradă după id (intern), cu localitatea și blocul geo (fapte OSM: lungime, bbox,
capete cu strada de la fiecare capăt). ?include=intersectii adaugă toate încrucișările.

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

Parametri de cale

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

Parametri de interogare

NumeTipDescriereValori acceptate
includelistăopțional text Secțiuni expandabile. intersectii

Cum se comportă

  • Servim fapte din geometria OSM (lungime, bbox, capete cu strada de la fiecare capăt), niciodată polilinia brută — de aici atribuire (ODbL).
  • geo e null când strada n-are geometrie OSM. ?include=intersectii adaugă toate încrucișările.

La ce folosește

  • Fișa completă a unei străzi (geo, lungime, capete) pe o pagină de detaliu.
  • Desenarea bounding box-ului străzii pe hartă pentru centrare și zoom.
  • Rezolvarea unei străzi alese din autocomplete în detalii plus intersecții, într-un singur apel cu ?include=intersectii.

Structura răspunsului

CâmpTipDescriere
data.id integer Id-ul intern al străzii (cheia publică a acestei entități).
data.nume string Denumirea entității.
data.tip string Tipul entității (cod brut; denumirile la /nomenclatoare/tipuri).
data.cod_postal string | null Codul poștal.
data.localitate.cod_siruta integer Codul SIRUTA al localității — chainable spre /localitati/{cod}.
data.localitate.nume string Denumirea localității.
data.localitate.judet.cod string Indicativul auto al județului.
data.localitate.judet.nume string Numele județului.
data.geo.lungime_m integer | null Lungimea arterei, în metri.
data.geo.bbox.min_lat number Latitudinea minimă a dreptunghiului care încadrează strada.
data.geo.bbox.min_lng number Longitudinea minimă a dreptunghiului.
data.geo.bbox.max_lat number Latitudinea maximă a dreptunghiului.
data.geo.bbox.max_lng number Longitudinea maximă a dreptunghiului.
data.geo.capete[].lat number Latitudinea unui capăt de arteră.
data.geo.capete[].lng number Longitudinea capătului.
data.geo.capete[].la[] string Străzile cu care se întâlnește artera în acel capăt.
data.atribuire string Atribuire ODbL, prezentă când servim fapte OSM.opțional
data.intersectii[].strada.id integer Id-ul străzii care intersectează.
data.intersectii[].strada.nume string Denumirea străzii care intersectează.
data.intersectii[].lat number Latitudine (WGS84).
data.intersectii[].lng number Longitudine (WGS84).
meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/strazi/16416
{
    "data": {
        "id": 16416,
        "nume": "Magnoliei",
        "tip": "strada",
        "cod_postal": "400487",
        "localitate": {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca",
            "judet": {
                "cod": "CJ",
                "nume": "Cluj"
            }
        },
        "geo": {
            "lungime_m": 105,
            "bbox": {
                "min_lat": 46.7569586,
                "min_lng": 23.5861447,
                "max_lat": 46.7578752,
                "max_lng": 23.5864852
            },
            "capete": [
                {
                    "lat": 46.7569586,
                    "lng": 23.5864852,
                    "la": [
                        "Caisului",
                        "Cireșilor"
                    ]
                }
            ]
        },
        "atribuire": "© OpenStreetMap contributors"
    },
    "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"
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitStrada nu există.
422validareUn parametru nu a trecut validarea (include); detalii spune care şi de ce.
429cota_depasitaCota 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": "validare",
        "mesaj": "Un parametru nu a trecut validarea (include); detalii spune care şi de ce.",
        "detalii": {
            "id": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}