Locations v1 / Geometrie & hărți

Puncte în zonă (batch)

⭐ Testează care puncte dintr-o listă cad într-o zonă — un UAT (uat=cod_siruta) sau un
poligon GeoJSON (poligon). Filtrarea comenzilor pe zonă, într-un singur apel.

POST

https://oneapi.ro/api/locations/v1/puncte-in-zona

Corpul cererii

Se trimite ca JSON, în corpul cererii (Content-Type: application/json) — nu în şirul de interogare.

NumeTipDescriereValori acceptate

uatopțional integer | null cod_siruta al UAT-ului zonei (sau poligon).

poligonopțional array | null Poligon GeoJSON (alternativă la uat).

puncteobligatoriu object[] Listă de {id?, lat, lng}, max 1000.

Într-un UAT Corpul cererii

{
    "uat": 54975,
    "puncte": [
        {
            "id": "centru",
            "lat": 46.7712,
            "lng": 23.6236
        },
        {
            "id": "departe",
            "lat": 44.4268,
            "lng": 26.1025
        }
    ]
}

Două puncte în Timișoara Corpul cererii

{
    "uat": 155243,
    "puncte": [
        {
            "id": "piata-unirii",
            "lat": 45.7565,
            "lng": 21.229
        },
        {
            "id": "aeroport",
            "lat": 45.8099,
            "lng": 21.3379
        }
    ]
}

Cu poligon propriu, nu UAT Corpul cererii

{
    "poligon": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    23.55,
                    46.75
                ],
                [
                    23.65,
                    46.75
                ],
                [
                    23.65,
                    46.8
                ],
                [
                    23.55,
                    46.8
                ],
                [
                    23.55,
                    46.75
                ]
            ]
        ]
    },
    "puncte": [
        {
            "id": "a",
            "lat": 46.7712,
            "lng": 23.6236
        },
        {
            "id": "b",
            "lat": 44.4268,
            "lng": 26.1025
        }
    ]
}

Un singur punct, într-o comună Corpul cererii

{
    "uat": 1071,
    "puncte": [
        {
            "id": "ciugud",
            "lat": 46.028,
            "lng": 23.61
        }
    ]
}

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Testează care puncte dintr-o listă cad într-o zonă — un UAT (uat=cod_siruta) sau un poligon GeoJSON (poligon).
Un singur apel pentru filtrarea comenzilor pe zonă. Fiecare punct poate avea un id propriu (altfel indexul).

La ce folosește

Filtrarea unui coș de comenzi pe zona de livrare: trimiți toate coordonatele într-un singur apel și afli care sunt livrabile.
Bucketing de clienți pe UAT sau poligon, pentru campanii sau rutare la depozitul potrivit.
Validarea în masă a punctelor unei flote/rețele de puncte de lucru față de o zonă definită.

Structura răspunsului

CâmpTipDescriere

data.in_zona[] string Indicii punctelor din cerere care cad în zonă, în ordinea în care au fost trimise.

data.rezultate[].id string Id-ul punctului — cel trimis, altfel indexul din listă.

data.rezultate[].in_zona boolean true dacă punctul cade în zonă.

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

Exemple de răspuns

body: {"uat": 54975, "puncte": [{"id": "centru", "lat": 46.7712, "lng": 23.6236}, {"id": "departe", "lat": 44.4268, "lng": 26.1025}]} — „centru” e în Cluj-Napoca, „departe” în Bucureşti.

POSThttps://oneapi.ro/api/locations/v1/puncte-in-zona

{
    "data": {
        "in_zona": [
            "centru"
        ],
        "rezultate": [
            {
                "id": "centru",
                "in_zona": true
            }
        ]
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

body: {"uat": 155243, "puncte": [{"id": "piata-unirii", "lat": 45.7565, "lng": 21.2290}, {"id": "aeroport", "lat": 45.8099, "lng": 21.3379}]}

POSThttps://oneapi.ro/api/locations/v1/puncte-in-zona

{
    "data": {
        "in_zona": [
            "piata-unirii"
        ],
        "rezultate": [
            {
                "id": "piata-unirii",
                "in_zona": true
            }
        ]
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

body: {"poligon": {"type": "Polygon", "coordinates": [[[23.55, 46.75], [23.65, 46.75], [23.65, 46.80], [23.55, 46.80], [23.55, 46.75]]]}, "puncte": [{"id": "a", "lat": 46.7712, "lng": 23.6236}, {"id": "b", "lat": 44.4268, "lng": 26.1025}]}

POSThttps://oneapi.ro/api/locations/v1/puncte-in-zona

{
    "data": {
        "in_zona": [
            "a"
        ],
        "rezultate": [
            {
                "id": "a",
                "in_zona": true
            }
        ]
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

body: {"uat": 1071, "puncte": [{"id": "ciugud", "lat": 46.0280, "lng": 23.6100}]}

POSThttps://oneapi.ro/api/locations/v1/puncte-in-zona

{
    "data": {
        "in_zona": [
            "ciugud"
        ],
        "rezultate": [
            {
                "id": "ciugud",
                "in_zona": true
            }
        ]
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": null
        }
    }
}

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.
422	parametri_invalizi	lipsă `puncte` sau zona (`uat`/`poligon`).
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": "parametri_invalizi",
        "mesaj": "lipsă puncte sau zona (uat/poligon)."
    }
}