Locations v1 / Străzi

Intersecțiile unei străzi

Toate străzile care încrucișează strada dată, cu punctul de intersecție (fapte OSM).

GET

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

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ă

Fapte OSM: fiecare rând = strada transversală plus punctul de încrucișare (lat/lng) — de aici atribuire (ODbL).
Iese gol fără eroare când strada n-are geometrie OSM (acoperire parțială) sau nu încrucișează nimic.
O transversală apare o dată pentru fiecare punct în care încrucișează strada, deci poate reveni de mai multe ori.

La ce folosește

Repere de tip „la intersecția cu ..." în instrucțiunile de livrare.
Segmentarea unei străzi pe tronsoane între intersecții pentru planificarea rutei.
Puncte de întâlnire la colț de stradă pentru preluarea coletului de către curier.

Structura răspunsului

CâmpTipDescriere

data[].strada object Strada transversală care încrucișează (id intern + nume).

data[].strada.id integer Id-ul intern al transversalei — cheia pentru /strazi/{id}.

data[].strada.nume string Denumirea străzii care intersectează.

data[].lat number Latitudinea punctului de încrucișare.

data[].lng number Longitudinea punctului de încrucișare.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/strazi/16416/intersectii

{
    "data": [
        {
            "strada": {
                "id": 14488,
                "nume": "Cireșilor"
            },
            "lat": 46.7569586,
            "lng": 23.5864852
        }
    ],
    "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"
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/14612/intersectii

{
    "data": [
        {
            "strada": {
                "id": 14380,
                "nume": "Gruia"
            },
            "lat": 46.777611,
            "lng": 23.5768591
        }
    ],
    "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"
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/103906/intersectii

{
    "data": [
        {
            "strada": {
                "id": 104348,
                "nume": "9 Mai"
            },
            "lat": 44.9241624,
            "lng": 25.4712168
        }
    ],
    "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"
    }
}

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