List area sets
The area sets the caller can read, newest first: each set's record, without its areas (GET one for those).
List area sets
/area-setsThe area sets the caller can read, newest first: each set's record, without its areas (GET one for those). A private set lists only for its creator. Invalid limit or cursor is 400. A server without a state store answers 409 "Area sets need a state store; this server keeps plans in memory".
Parameters
Query parameters
limitintegerOptionalDefault
50≥ 1, ≤ 100Page size, 1-100.
cursorstringOptionalPage to read:
next_cursorfrom the previous page.
Responses
200 OK
Area sets and next cursor.
itemsarray of objectsRequiredNewest first.
ShowHide 14 child fields in each item
idstringRequiredFormat
uuidIts id.
namestringRequiredIts name, 1 to 100 characters.
countintegerRequired≥ 1
Areas in it.
acresnumberRequiredIts areas' acres added up, rounded to 0.01.
bboxarray of numbersRequired4 items
West, south, east and north of its areas' outer rings, WGS 84.
crsobjectRequiredThe coordinate system the file was read in, and how sure that is.
ShowHide 6 child fields
codestringRequiredThe system read: an EPSG code, as EPSG:2277, or the .prj's name when no supported system matches it (it was read through the .prj itself).
namestringRequiredIts name, as NAD83 / Texas Central (ftUS).
sourcestringRequiredrequest: the request's crs; file: the .prj, the GeoJSON (crs member, or degrees per RFC 7946) or a KML (WGS 84); detected: the first supported system that puts the areas on the dataset.
"request""file""detected"datum_shiftstring or nullRequirednadcon_conus: NAD27, shifted to NAD83 with NOAA's NADCON conus grid; else null.
"nadcon_conus"max_offset_ftintegerRequired≥ 0
The largest alternative's offset_ft, or 0: how far the areas could be off if the file is in another system that also fits.
alternativesarray of objectsRequiredWith detection: the other systems that fit, in preference order, under 1 ft apart listed once.
ShowHide 3 child fields in each item
codestring or nullRequiredIts EPSG code; null for an international-foot variant, which crs can't name.
namestringRequiredIts name.
offset_ftintegerRequired≥ 1
The farthest a sampled vertex lands from where it is read now, ft.
name_fieldstring or nullRequiredThe field the areas' names came from, or null.
fileobject or nullRequiredThe uploaded file; null from a JSON body.
ShowHide 3 child fields
namestring or nullRequiredThe file part's name, or null without one.
bytesintegerRequired≥ 0
Its size.
sha256stringRequiredIts SHA-256, hex.
visibilitystringRequiredprivate: its signed-in creator only; tenant: every user of the tenant.
"private""tenant"created_bystring or nullRequiredIts signed-in creator's email, or null.
created_atstringRequiredFormat
date-timeWhen it was kept.
updated_atstringRequiredFormat
date-timeWhen it last changed.
name_fieldsarray of stringsOptionalOnly for a set made with name_fields: those fields as the file spells them, in the order sent; name_field is the first.
name_separatorstringOptionalOnly for a set made with name_fields: what joined their values.
next_cursorstring or nullRequiredNext page, null at end.
Errors
| Status | When |
|---|---|
| 409 | A server without a state store answers 409 "Area sets need a state store; this server keeps plans in memory". |
Shared errors400401403500What they mean