Airports
Examples | Pricing | Mandatory Parameters | Commands | Optional parametersAn airport is any landing place for aircraft, including seaports and heliports.
Entry pointhttps://www.avdelphi.com/api/1.00/airports.svc
Parameter | Type | Values |
---|---|---|
api_key |
mandatory | Your API Key |
api_password |
mandatory | Your API Password. Send this OR an access_token |
api_access_token |
mandatory | Your API access token which can be used instead of sending your password. |
cmd |
mandatory | API Command |
itemlist |
mandatory | List of fields to return. Each command has a specific list of items that can be returned. |
format |
optional |
Data return type XML,JSON,CSV or CSV-
|
search parameter |
see note below | Each command has a set of parameters that can be specified to identify the target data, such as registration, serial number etc. |
Examples
Get basic identity information for an airport by IATA codehttps://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&cmd=info&code_iata=zrh&itemlist=title;code_iata;code_icao
Result (JSON)
{ "api":"airports", "version":1, "command":"info", "num_results":1, "result_type":"valid", "results_limit":2, "rate_limit": { "airports": { "current":5, "maximum":5000 } }, "result": [ { "code_iata":"ZRH", "code_icao":"LSZH", "title":"Z\u00fcrich" } ] }
Get basic identity information for an airport by ICAO code
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&cmd=info&code_icao=lszh&itemlist=title;code_iata;code_icao
Result (JSON)
{ "api":"airports", "version":1, "command":"info", "num_results":1, "result_type":"valid", "results_limit":2, "rate_limit": { "airports": { "current":5, "maximum":5000 } }, "result": [ { "code_iata":"ZRH", "code_icao":"LSZH", "title":"Z\u00fcrich" } ] }
Get basic identity information for an airport by name
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&cmd=info&name=zurich&itemlist=title;code_iata;code_icao
Result (JSON)
{ "api":"airports", "version":1, "command":"info", "num_results":2, "result_type": "valid", "results_limit":3, "rate_limit": { "airports": { "current":8, "maximum":5000 } }, "result": [ { "code_iata":"", "code_icao":"", "title":"Universit\u00e4tsspital Z\u00fcrich" }, { "code_iata":"ZRH", "code_icao":"LSZH", "title":"Z\u00fcrich" } ] }
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&cmd=info&name=zurich&itemlist=title;code_iata;code_icao&format=csv
Result (CSV)
#api=airports #version=1 #command=info #result_type=valid #code_iata,code_icao,title ,,"Universitätsspital Zürich" ZRH,LSZH,Zürich
https://www.avdelphi.com/api/1.0/airports.svc?api_key=TESTAPIKEY&api_access_token=TESTAPIACCESSTOKEN&cmd=info&name=zurich&itemlist=title;code_iata;code_icao&format=xml
Result (XML)
<?xml version="1.0"?> <data> <api>airports</api> <version>1</version> <command>get</command> <num_results>2</num_results> <result_type>valid</result_type> <results_limit>3</results_limit> <rate_limit> <airports> <current>11</current> <maximum>5000</maximum> </airports> </rate_limit> <result> <item0> <code_iata/> <code_icao/> <title>Universitätsspital Zürich</title> </item0> <item1> <code_iata>ZRH</code_iata> <code_icao>LSZH</code_icao> <title>Zürich</title> </item1> </result> </data>
Pricing
This is a pay-as-you-go API. Simply fund your account to use it.
Mandatory Parameters
Mandatory | |
Hexadecimal value of your API key. Get your API key here if you don't have one. |
|
YES |
api_key=NTlhZGUl7kZW
Back to top
Mandatory (You must send either password or access token with each request) | |
Hexadecimal value of your API password. Get your API key here if you don't have one. |
|
YES |
api_password=ciUyQmdPWTJaTGNQc2pkU05tRlVNaWZZ11NpdCUyRmVpVEF6THBm7SUzRA
Back to top
Mandatory (You must send either password or access token with each request) | |
Hexadecimal value of your API access token. Click on any API Key here to manage access tokens. |
|
YES |
api_access_token=2d1a099fd880c0fcfd6fd5e63a769e11b2c2db92
Back to top
Commands
Specify the command you want using the cmd= parameter
Mandatory | |
API command to execute | |
No |
Command | Purpose |
---|---|
charts | Gets airport charts where available. NOTE: Charts should not be used for aeronautical operations. |
images | Get images for this airport |
info | Retrieve information about a specific airport. The list of data fields returned is specified using the itemlist parameter. |
metar | Gets the current METAR report for the airport |
metsat | Get recent weather satellite images covering this airport |
news | Show any recent news items relating to this airport. |
notam | Gets the most recent NOTAMs for the airport |
taf | Gets the current TAF (Terminal Area Forecast) for the airport |
weather | Gets the current weather conditions at the airport. |
cmd=charts
cmd=images
cmd=info
Back to top
One of the keywords listed below can be with the command.
Gets airport charts where available. NOTE: Charts should not be used for aeronautical operations. | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_icao=tjmz |
Get images for this airport | |||||
Multiple parameters will be ANDed together. | |||||
| |||||
code_icao=lszh |
Retrieve information about a specific airport. The list of data fields returned is specified using the itemlist parameter. | |||||||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||||||
| |||||||||||||||||
code_icao=kjfk |
Gets the current METAR report for the airport | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_icao=lszh |
Get recent weather satellite images covering this airport | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_iata=muc |
Show any recent news items relating to this airport. | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_iata=lhr |
Gets the most recent NOTAMs for the airport | |||||||||
Multiple parameters will be ANDed together. | |||||||||
| |||||||||
code_icao=kden |
Gets the current TAF (Terminal Area Forecast) for the airport | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_icao=klax |
Gets the current weather conditions at the airport. | |||||||||||||
Multiple parameters will be ANDed together. | |||||||||||||
| |||||||||||||
code_iata=gva |
Optional Parameters
These parameters are not required but can be added if needed. If not specified, some items default to preset values.
Optional | |
Specifies the data return format JSON,XML or CSV(-). By default, data is returned as JSON. | |
No | |
json |
format=xml
format=csv
format=csv-
format=json
Back to top
Optional depending on command used. Some commands return default data, others allow you to specify which fields to return. | |
List of fields to retrieve separated with semi-colons. | |
No |
Fieldname | Description |
---|---|
airport_unid | |
aka | |
alternate_spellings | Alternate spellings for the airport name, including language variants |
city | |
code_iata | 3 letter IATA allocated code for the airport |
code_icao | 4 letter ICAO allocated code for the airport |
common_name | The common name for this airport |
country | |
country_iso | |
display_names | |
location | |
name | Any other name used for this airport |
region | |
title | Common name for the airport |
zip_code |
itemlist=airport_unid;aka;alternate_spellings
Back to top