Advisory Activities

Civil aviation authorities issue NOTAMs (Notice to Airmen) to warn pilots about changes or events taking place in airports and airspaces.

With Advisory Activities we want to provide a similar service to pilots and let them know about possible dangers in the sky that are not covered by NOTAMs. By using this service, a drone pilot can publish the area he is planning to affect and let pilots using Air Navigation Pro know about his intentions. For example: a drone pilot can publish that he is planning a flight around the castle of Gruyere tomorrow from 2pm to 4pm. Aircraft pilots will see this information live on the Moving Map of Air Navigation Pro and handle accordingly.

Base URL

The REST API is accessible from the following URL:

Base URL
http://uav.airnavigation.aero
Test URL
http://test-uav.airnavigation.aero and http://test-myuav.airnavigation.aero. Please be aware that you will need to register again on this test websites in order to use them. Tokens are not shared between test and production server and test database is not guaranteed to be up to date.

Authentication and Authorization

In order to use the service, you'll need to register for an account. Once registered, you are given an Authorization Token.

This Authorization Token will be used to identify yourself when sending requests to the REST API server.

To authenticate, the token should be included in the Authorization HTTP header. This token should be prefixed by the string Token, with whitespace separating the two strings like in the following example:

Authorization: Token 5ab0129ac330f5d8f477ab4db5ed1ebaf2b688b0

You can get your vendor token by following these simple steps:

  • Go to the vendor login page.
  • Login using your vendor credentials.
  • View your dashboard.
  • Under the "Account Details" panel you will see your "API Authorization Token".

Register user for the Advisory Activity service

End users need to register on myuav.airnavigation.aero in order to use the NOTAMs and Push Position service. They also not forget to validate their account email.

Get End User Token

This API call will allow you to get the necessary End User API Token in order to use it on the NOTAM and Push Position services.

API Endpoint
/api/endusers/
HTTP Method
POST
Sample Request Body

        

Where 318bcdd888967e66e3ff5b38823ca1d2 is the md5 checksum of the user provided password. In this example, the original password was ThiSisQuit3AL0ngPassw0rd..

Request Parameters
Parameter Type Required Remarks
email string Yes The end user email
password string Yes The end user password
CURL equivalent
Success Response

The API call is a success if you receive HTTP status 200 OK.


        

Submit Advisory Activity

This API call will allow you to submit NOTAMs to the Air Navigation database.

API Endpoint

/api/private-notams/
HTTP Method
POST
Sample Request Body

        
Request Parameters
Parameter Type Required Remarks
user_token string Yes The end user token
latitude decimal Yes up to 10 digits and up to 6 decimal places
longitude decimal Yes up to 10 digits and up to 6 decimal places
radius decimal Yes in kilometers, up to 7 digits and up to 2 decimal places
max_elevation decimal Yes in meters, up to 10 digits and up to 2 decimal places
max_elevation_type integer No (default: 1) 1: MSL, 2: AGL
aircraft_type integer No (default: 1) 1: drone
number_of_aircraft integer No (default: 1) up to 32767
start datetime Yes NOTAM start datetime
end datetime Yes NOTAM end datetime
message string No
CURL equivalent
Success Response

The API call is a success if you receive HTTP status 201 CREATED.


            

You will also receive the id of the Advisory Activity that you submitted.

Update Advisory Activity

This API call will allow you to update a NOTAM in the Air Navigation database.

API Endpoint

/api/private-notams/[notam_id]/
HTTP Method
PUT
Sample Request Body

        
Request Parameters
Parameter Type Required Remarks
user_token string Yes The end user token
latitude decimal Yes up to 10 digits and up to 6 decimal places
longitude decimal Yes up to 10 digits and up to 6 decimal places
radius decimal Yes in kilometers, up to 7 digits and up to 2 decimal places
max_elevation decimal Yes in meters, up to 10 digits and up to 2 decimal places
max_elevation_type integer No (default: 1) 1: MSL, 2: AGL
aircraft_type integer No (default: 1) 1: drone
number_of_aircraft integer No (default: 1) up to 32767
start datetime Yes NOTAM start datetime
end datetime Yes NOTAM end datetime
message string No
CURL equivalent
Success Response

The API call is a success if you receive HTTP status 200 OK.


            

You will also receive the id of the Advisory Activity that you updated.

List Advisory Activities

This service will allow you to list all the active advisory activities from the server.

API Endpoint
/api/private-notams/
HTTP Method
GET
CURL equivalent
Success Response

The API call is a success if you receive HTTP status 200 OK.


          

Cancel Advisory Activity

This API call will allow you to cancel a specific NOTAM on Air Navigation database.

API Endpoint
/api/private-notams/cancel/
HTTP Method
POST
Sample Request Body

        
Request Parameters
Parameter Type Required Remarks
notam_id integer Yes The NOTAM internal database identifier
user_token string Yes The end user token
CURL equivalent
Success Response

The API call is a success if you receive HTTP status 200 OK.