oneapi
Sign in
Locations v1 / Străzi

Street detail

A street by its (internal) id, with its locality and the geo block (OSM facts: length, bounding box, endpoints with the street at each end). ?include=intersectii adds every crossing.

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

Path parameters

NameTypeDescriptionExample
idrequired string Internal identifier of the street — obtained from a street search.

Query parameters

NameTypeDescriptionAccepted values
includelistoptional text Expandable sections. intersectii

How it behaves

  • We serve facts derived from the OSM geometry (length, bounding box, endpoints with the street at each end), never the raw polyline — hence atribuire (ODbL).
  • geo is null when the street has no OSM geometry. ?include=intersectii adds every crossing.

What it is for

  • The full record of a street (geometry, length, endpoints) on a detail page.
  • Drawing the street's bounding box on a map for centring and zoom.
  • Resolving a street picked from autocomplete into details plus intersections, in a single call with ?include=intersectii.

Response structure

FieldTypeDescription
data.id integer The street's internal id (the public key of this entity).
data.nume string The name of the entity.
data.tip string Entity type (raw code; the full names are at /nomenclatoare/tipuri).
data.cod_postal string | null The postal code.
data.localitate.cod_siruta integer The locality's SIRUTA code — chainable to /localitati/{cod}.
data.localitate.nume string The name of the locality.
data.localitate.judet.cod string The county's registration prefix.
data.localitate.judet.nume string The name of the county.
data.geo.lungime_m integer | null The length of the thoroughfare, in metres.
data.geo.bbox.min_lat number The minimum latitude of the rectangle enclosing the street.
data.geo.bbox.min_lng number The minimum longitude of the rectangle.
data.geo.bbox.max_lat number The maximum latitude of the rectangle.
data.geo.bbox.max_lng number The maximum longitude of the rectangle.
data.geo.capete[].lat number The latitude of one end of the thoroughfare.
data.geo.capete[].lng number The longitude of that end.
data.geo.capete[].la[] string The streets the thoroughfare meets at that end.
data.atribuire string ODbL attribution, present whenever we serve OSM facts.opțional
data.intersectii[].strada.id integer The id of the crossing street.
data.intersectii[].strada.nume string The name of the crossing street.
data.intersectii[].lat number Latitude (WGS 84).
data.intersectii[].lng number Longitude (WGS 84).
meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Response examples

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"
        }
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403feature_indisponibilThe current plan does not include the feature the route depends on.
404negasitThe street does not exist.
422validareA parameter failed validation (include); detalii says which and why.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "A parameter failed validation (include); detalii says which and why.",
        "detalii": {
            "id": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}