Location Data

Points

A point is one record in a collection: a title, a location, and properties that follow the collection's schema.

A point

{
  "id": "ft_Rk2x…",
  "collection": "warehouses",
  "title": "Warehouse #12",
  "description": "Main distribution center",
  "location": { "lat": 35.7219, "lng": 51.3347 },
  "properties": { "status": "active", "capacity": 1200, "manager": "Ali" },
  "createdAt": "2026-10-27T10:30:00.000Z",
  "updatedAt": "2026-10-27T10:30:00.000Z"
}

Parameter	Type	Description
title	string	Required, up to 200 characters.
description	string	Optional, up to 2000 characters.
location	{ lat, lng }	Required, WGS84.
properties	object	Keys must be fields of the collection; values must match their types.

Create

Send one point, or a list of up to 100 (validated together — all or nothing). Each point costs 2 units.

curl -X POST "https://orviamaps.ir/api/v1/collections/warehouses/features" \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "title": "Warehouse #12", "location": { "lat": 35.7219, "lng": 51.3347 },
        "properties": { "status": "active", "capacity": 1200 } }'

Update

PATCH changes only what you send. In properties, a value of null removes that property (unless it's required).

PATCH /api/v1/collections/warehouses/features/ft_Rk2x…
{ "properties": { "capacity": 1500, "manager": null } }

Read, list, delete

GET    /api/v1/collections/warehouses/features/ft_Rk2x…
GET    /api/v1/collections/warehouses/features?limit=50            → { features, nextCursor }
GET    /api/v1/collections/warehouses/features?cursor=<nextCursor> → the next page
DELETE /api/v1/collections/warehouses/features/ft_Rk2x…