AOI Metadata

The following schema is used to describe and store all AOIs in GO, including both user-created and catalog AOIs provided by Orbital Insight.

FieldDescriptionTypeExampleUser-editableReturned by APIAuto-calculated
nameAOI namestringFord Dearborn:white-check-mark::white-check-mark:
categoryUsed to categorize AOIsstringIndustrial:white-check-mark:
typeUsed to categorize AOIsstringFactory:white-check-mark:
tagsAdds context to AOIlist of stringsAutos, Assembly:white-check-mark:
attributesCustom metadata. Stores custom fields for user-uploaded AOIs.JSON{"capacity": 500}:white-check-mark:
countryAdmin level 0 boundarystringUnited States:white-check-mark::white-check-mark:
stateAdmin level 1 boundarystringMichigan:white-check-mark::white-check-mark:
data_sourceWho created the AOIstringOrbital Insight:white-check-mark:

Country / State Geocoding

We use a global set of country/region (admin level 0) and state/province (admin level 1) boundaries from NaturalEarth (v4.1). For disputed regions, we make no adjudication and use the boundaries as-is.

For AOIs that lie outside these boundaries, we assign country/state based on the closest admin boundary within ~50 kilometers. Any AOIs that are further out to sea will not have an assigned country/state.