Surface v2 GeoJSON
POST/v2/surface/geojsonLast modified: 6 months ago
Scope: surface:create
Combine authoritative data provided by Airspace Link with your own GIS data to deliver profile services tailored to your needs. Over 65 datasets that can be used as a feature within the surface engine to aggregate and process vast amounts of data. This endpoint returns the GeoJSON feature of any intersecting feature intersecting the geometry parameter.
Request
Header Params
Content-Type
enum<string>
required
Allowed value:
application/json;charset=UTF-8
Example:
application/json;charset=UTF-8
Authorization
string
required
Authorization bearer accessToken generated in Authorization step
Example:
{{access-token}}
Body Params application/json
type
string
required
coordinates
array [array]
required
layers
array [object {2}]
required
Array of layer objects. Valid length of 1-5.
code
string
required
fields
array[string]
required
resolution
integer
required
Hex grid resolution.
Example
{
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-83.24561243042268,
42.239733056506026
],
[
-83.24765492978501,
42.2396984810365
],
[
-83.24969318907937,
42.239594826402715
],
[
-83.25172297708134,
42.23942230777937
],
[
-83.25374008023513,
42.23918128329237
],
[
-83.25574031144062,
42.23887225327183
],
[
-83.25771951878461,
42.238495859208754
],
[
-83.25967359419712,
42.238052882417286
],
[
-83.26159848201469,
42.237544242405505
],
[
-83.26349018743238,
42.23697099495823
],
[
-83.2653447848265,
42.23633432993585
],
[
-83.26715842593087,
42.235635568793896
],
[
-83.26892734784876,
42.234876161828595
],
[
-83.27064788088391,
42.23405768515421
],
[
-83.27231645617422,
42.233181837418705
],
[
-83.27392961311195,
42.23225043626445
],
[
-83.27548400653484,
42.23126541454169
],
[
-83.27697641367291,
42.23022881628271
],
[
-83.27840374083695,
42.229142792445074
],
[
-83.27976302983421,
42.22800959643316
],
[
-83.2810514640984,
42.22683157940726
],
[
-83.28226637452069,
42.22561118539024
],
[
-83.28340524497085,
42.224350946181936
],
[
-83.28446571749559,
42.223053476092225
],
[
-83.28544559718493,
42.22172146650359
],
[
-83.28634285669561,
42.22035768027479
],
[
-83.28715564042332,
42.21896494599731
],
[
-83.28788226831435,
42.21754615211662
],
[
-83.28852123930999,
42.2161042409306
],
[
-83.2890712344161,
42.21464220247772
],
[
-83.28953111939256,
42.21316306832761
],
[
-83.28989994705654,
42.211669905287195
],
[
-83.29017695919588,
42.2101658090354
],
[
-83.29036158808896,
42.20865389769969
],
[
-83.2904534576281,
42.207137305387825
],
[
-83.2904523840446,
42.205619175688355
],
[
-83.29035837623435,
42.20410265515329
],
[
-83.29017163568462,
42.20259088677642
],
[
-83.28989255600082,
42.20108700348093
],
[
-83.28952172203701,
42.19959412162961
],
[
-83.28905990863004,
42.198115334571405
],
[
-83.28850807894223,
42.19665370623712
],
[
-83.28786738241583,
42.19521226479804
],
[
-83.28713915234317,
42.19379399640014
],
[
-83.28632490305912,
42.192401838986996
],
[
-83.28542632676141,
42.19103867622402
],
[
-83.28444528996576,
42.189707331536454
],
[
-83.28338382960348,
42.188410562273475
],
[
-83.28224414877018,
42.18715105401032
],
[
-83.28102861213422,
42.18593141500003
],
[
-83.27973974101499,
42.18475417078622
],
[
-83.27838020814099,
42.18362175898796
],
[
-83.27695283209961,
42.18253652426734
],
[
-83.27546057148854,
42.18150071348986
],
[
-83.27390651878284,
42.18051647108775
],
[
-83.27229389392922,
42.1795858346356
],
[
-83.270626037681,
42.1787107306471
],
[
-83.26890640468766,
42.17789297060168
],
[
-83.26713855635333,
42.1771342472091
],
[
-83.26532615347818,
42.17643613091931
],
[
-83.26347294869863,
42.1758000666851
],
[
-83.26158277874124,
42.175227370983656
],
[
-83.25965955650638,
42.17471922910343
],
[
-83.25770726299743,
42.17427669270154
],
[
-83.25572993911243,
42.17390067763687
],
[
-83.25373167731439,
42.17359196208308
],
[
-83.25171661319736,
42.17335118492536
],
[
-83.2496889169654,
42.17317884444441
],
[
-83.24765278484118,
42.173075297289955
],
[
-83.24561243042268,
42.173040757746094
],
[
-83.24357207600423,
42.173075297289955
],
[
-83.24153594388001,
42.17317884444441
],
[
-83.23950824764799,
42.17335118492536
],
[
-83.23749318353102,
42.17359196208308
],
[
-83.23549492173298,
42.17390067763687
],
[
-83.23351759784798,
42.17427669270154
],
[
-83.23156530433899,
42.174719229103424
],
[
-83.2296420821041,
42.175227370983656
],
[
-83.22775191214673,
42.1758000666851
],
[
-83.22589870736722,
42.17643613091931
],
[
-83.22408630449208,
42.1771342472091
],
[
-83.22231845615775,
42.17789297060168
],
[
-83.22059882316441,
42.1787107306471
],
[
-83.21893096691619,
42.1795858346356
],
[
-83.21731834206253,
42.18051647108775
],
[
-83.21576428935683,
42.18150071348986
],
[
-83.21427202874574,
42.18253652426734
],
[
-83.21284465270436,
42.18362175898796
],
[
-83.21148511983041,
42.18475417078622
],
[
-83.21019624871114,
42.18593141500003
],
[
-83.20898071207519,
42.18715105401032
],
[
-83.20784103124188,
42.188410562273475
],
[
-83.20677957087965,
42.189707331536454
],
[
-83.20579853408401,
42.19103867622402
],
[
-83.20489995778628,
42.192401838986996
],
[
-83.20408570850223,
42.19379399640014
],
[
-83.20335747842952,
42.19521226479804
],
[
-83.20271678190313,
42.19665370623712
],
[
-83.20216495221538,
42.198115334571405
],
[
-83.2017031388084,
42.19959412162961
],
[
-83.20133230484453,
42.20108700348093
],
[
-83.20105322516079,
42.20259088677642
],
[
-83.200866484611,
42.20410265515329
],
[
-83.20077247680081,
42.205619175688355
],
[
-83.20077140321725,
42.207137305387825
],
[
-83.20086327275641,
42.20865389769969
],
[
-83.20104790164953,
42.2101658090354
],
[
-83.20132491378887,
42.211669905287195
],
[
-83.20169374145279,
42.21316306832761
],
[
-83.20215362642926,
42.21464220247772
],
[
-83.20270362153542,
42.2161042409306
],
[
-83.20334259253106,
42.21754615211662
],
[
-83.20406922042208,
42.21896494599731
],
[
-83.20488200414974,
42.22035768027479
],
[
-83.20577926366042,
42.22172146650359
],
[
-83.20675914334977,
42.223053476092225
],
[
-83.20781961587451,
42.224350946181936
],
[
-83.20895848632468,
42.22561118539024
],
[
-83.21017339674701,
42.22683157940726
],
[
-83.21146183101115,
42.22800959643316
],
[
-83.21282112000847,
42.22914279244508
],
[
-83.2142484471725,
42.23022881628271
],
[
-83.21574085431057,
42.23126541454169
],
[
-83.21729524773342,
42.23225043626445
],
[
-83.21890840467118,
42.23318183741871
],
[
-83.22057697996149,
42.23405768515421
],
[
-83.22229751299659,
42.23487616182859
],
[
-83.22406643491448,
42.235635568793896
],
[
-83.22588007601885,
42.23633432993585
],
[
-83.22773467341298,
42.236970994958234
],
[
-83.22962637883067,
42.237544242405505
],
[
-83.23155126664824,
42.238052882417286
],
[
-83.23350534206075,
42.238495859208754
],
[
-83.23548454940475,
42.23887225327183
],
[
-83.23748478061022,
42.23918128329236
],
[
-83.23950188376402,
42.23942230777937
],
[
-83.24153167176604,
42.239594826402715
],
[
-83.24356993106035,
42.2396984810365
],
[
-83.24561243042268,
42.239733056506026
]
]
]
},
"layers": [
{
"code": "airports",
"fields": [
"name",
"type_code",
"ident"
]
},
{
"code": "community_advisories",
"fields": [
"advisory_category_id",
"contact_phone",
"contact_email",
"description",
"end_time",
"id",
"name",
"timezone_name",
"start_time",
"url"
]
},
{
"code": "class_airspace_schedule",
"fields": [
"ident",
"class",
"applies_json"
]
},
{
"code": "faa_helipads",
"fields": [
"name",
"type_code",
"ident"
]
},
{
"code": "mtr_buffer",
"fields": [
"*"
]
},
{
"code": "national_parks_simple",
"fields": [
"unit_name",
"unit_code"
]
},
{
"code": "notams",
"fields": [
"*"
]
},
{
"code": "nsufr_ft",
"fields": [
"reason",
"poc",
"base",
"facility"
]
},
{
"code": "nsufr_pt",
"fields": [
"reason",
"alertype",
"activetime",
"endtime",
"poc",
"base",
"facility"
]
},
{
"code": "recreational_flyer_fixed_sites",
"fields": [
"site_name",
"poc"
]
},
{
"code": "satr",
"fields": [
"*"
]
},
{
"code": "seaport",
"fields": [
"*"
]
},
{
"code": "sporting_tfr",
"fields": [
"faa_stadium_global_id",
"event_name",
"start_time",
"end_time",
"league"
]
},
{
"code": "stadium",
"fields": [
"name",
"global_id"
]
},
{
"code": "sua_schedule",
"fields": [
"type_code",
"timesofuse",
"start_time",
"end_time",
"name"
]
},
{
"code": "tfr",
"fields": [
"notam_id",
"tfr_type",
"tfr_area",
"lower_alt",
"lalt_type",
"upper_alt",
"ualt_type",
"location",
"reason",
"issue_date",
"start_time",
"end_time",
"url",
"status",
"daily_start",
"daily_end",
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
]
},
{
"code": "uasfm_ceiling",
"fields": [
"*"
]
},
{
"code": "washington_frz"
}
]
}Request samples
Responses
Successful response(200)
Your request was invalid JSON or is using invalid types(400)
Your request timed out; try reducing the size of the request(408)
Part of your request had invalid values(422)
Internal error reaching data(500)
Successful response
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
statusCode
integer
required
message
string
required
data
array [object {3}]
required
type
string
optional
geometry
object
optional
properties
object
optional
Example
{
"statusCode": 200,
"message": "success",
"data": [
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-83.1983218426122,
42.1668007862236
],
[
-83.1991781217225,
42.1651170058817
]
]
]
},
"properties": {
"applies_json": null,
"class": "B",
"ident": "APT",
"type": "data_source"
}
}
]
}Last modified: 6 months ago