- Introduction
- Authorization
- Advisories
- Briefing
- LAANC SDSP
- Overview
- ASL Operations
- LAANC Operations
- LAANC Authorizations
- Operation v2POST
- Create Ephemeral OperationsPOST
- Risk
- Aviation
- Surface
- Route
- Check
- Elevation - NEW
- Map Vector Tiles - NEW
Surface v2 GeoJSON
Sandbox
Sandbox
POST
/v2/surface/geojson
Last modified:2024-05-17 17:31:02
surface:creategeometry 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
accessToken generated in Authorization stepExample:
{{access-token}}
Body Params application/json
type
string
required
coordinates
array [array]
required
layers
array [object {2}]
required
code
string
required
fields
array[string]
required
resolution
integer
required
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
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v2/surface/geojson' \
--header 'Authorization: ' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"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"
}
]
}'Responses
🟢200Successful response
application/json
Body
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"
}
}
]
}🟠400Your request was invalid JSON or is using invalid types
🟠408Your request timed out; try reducing the size of the request
🟠422Part of your request had invalid values
🔴500Internal error reaching data
Modified at 2024-05-17 17:31:02