View source for Select a waypoint from the database

<languages />
<translate>
<br />
----
[[File:wpimage.jpg]]By pressing on this button at the top toolbar on an iPad or within the toolbar in an iPhone/iPod Touch (accessible from the «screwdriver» button), you can have access to the waypoints database.
__TOC__
<br />
==Quick Search== <!--T:3-->
The Quick Search will allow you to not only get quickly to a desired waypoint, but also to create new ones by using certain commands. The results can be selected as direct-to destinations, added to the current route, shown on map or added as an user waypoint (if it isn't already a waypoint in the database).

<!--T:43-->
[[File:6854198.jpg|300px]]

===Search by Identifier=== <!--T:44-->
By entering at least 3 characters in the search field the search engine will start searching in the database. It will look after:
* IDs (ICAO Codes or Navaids IDs) in the waypoints database (Custom user waypoints incl.)
* Name of cities or mountains
* Documents stored in the document browser
<br />
The results will be displayed under categories (Waypoints, Radionavigation Beacons, Airports).

===Search Coordinates=== <!--T:5-->
You can also enter coordinates in the following formats / grids / datums:
{|
|
* WGS84 in DD:MM:SS
* WGS84 in DD:MM.decimal
* WGS84 in DD.decimal
* Standard UTM
* UTM with bands
* UPS
* MGRS 100m
* MGRS 10m
* MGRS 1m
|
* Irish grid without zone
* Irish grid with zone
* NZ Grid 1949
* NZ Grid 2000
* Swissgrid (CH1903)
* UK Grid without zone
* UK Grid with zone
* Swedish grid RT90
* Swedish grid SWERED99TM
|}

<!--T:6-->
The engine will try to interpret the input to match the correct datum. In order to avoid ambiguity between grids it is necessary to enter the 2-letter code of the target country:

<!--T:7-->
Irish grids : IE <br />
New Zealand grids : NZ <br />
Swiss grid : CH <br />
UK grids : UK <br />
Swedish grids : SE <br />

====Examples==== <!--T:8-->
{| class="wikitable"
|-
|WGS84 in DD.decimal
|46.8943 -5.4535
|-
|WGS84 in DD:MM:SS
|23:34:56N 145:12:01W
|-
|Swissgrid
|CH 553986 200005
|-
|Swedish grid
|SE 6669189 486557
|-
|MGRS
|32TKR6770698424
|}

<!--T:9-->
If a valid coordinate has been entered the result will appear as the first line of the search result. A true bearing and distance from the current GPS location will be displayed as well.

===Searching relative waypoints=== <!--T:10-->
By using similar syntax as when looking for coordinates and adding commands, it is possible to create waypoints relative to a known location. 3 Modes are available:
* Location, Direction, Distance
* Location, Direction, Speed, Time
* Location, Direction, Location, Direction
<br />
'''Location''': can be either a coordinate or a waypoint identifier

<!--T:11-->
'''Direction''': can be true bearing or radial.
* True bearing will be an angle from 0 to 360 and prefixed with a B, e.g. B055.
* Radial will be treated as a magnetic bearing and will be an angle from 0 to 360, prefixed with a R, e.g. R220. It will be converted to true by using the current magnetic variation model.
<br />
'''Distance''': a value in nautical miles prefixed with a D. An optional suffix will allow using other units. Example: D120KM.
Supported units:
* SM (Statute miles)
* KM (Kilometers)
* M (meters)
<br />
'''Speed''': a value in knots prefixed with a S or GS. An optional suffix will allow using other units. Example: S100KMH.
Supported units:
* MPH (statue miles per hour)
* KMH (kilometer per hour)
* MPS (meters per second)
<br />
'''Time''': can be a relative in minutes or an absolute time in HH:MM UTC, prefixed with T or AT for absolute. Example: AT08:21.

====Examples==== <!--T:12-->
=====Location, Direction, Distance=====
For these examples we will use the WGS84 in DD:MM:SS format DD:MM:S

<!--T:13-->
Creating a waypoint knowing a radial and DME to a navigation aid
For this we need to enter a string with the following information: Location of the navigation aid (ICAO Code or Coordinates), radial and distance to the aid (in Nautical miles, Statute miles, Kilometers or meters)

<!--T:14-->
Let's say I want to create a point that is on radial 275 of the VOR of Geneva (GVA) at 25NM DME
I will have to enter the following string in the tool:
'''GVA, R275, D25''' 

<!--T:15-->
The tool will choose the navigation aid with that name that is nearest to your actual position. Alternatively you can enter the coordinates: 

<!--T:16-->
'''46:15:12 N 06:08:14 E, R275, D25'''

<!--T:17-->
If you want to use the true bearing instead of the radial you have to change the R for a B. An to change the unit just add SM for statute mile, KM for Kilometer or M for meter at the end of Distance:

<!--T:18-->
'''GVA, B275, D25KM'''

=====Location, Direction, Speed, Time===== <!--T:19-->
Let 's say you are flying and you are requested by ATC to report your position 5 minutes after passing over GVA. You are flying at 108 knots GS and you are on the radial 275 of GVA.

<!--T:20-->
You can enter this String and the tool will search for that point:
GVA, R275, S108, T5

<!--T:21-->
You can also enter a specific time in UTC. Use the Code AT before the time for this:
GVA, R275, S108, AT12:58

<!--T:22-->
You can also enter the speed in statute miles per hour, kilometers per hour and meters per second. Enter just MPH, KMH or MPS after the speed.

=====Location, Direction, Location, Direction===== <!--T:23-->
Creating a waypoint knowing the radials of two navigation aids
You can create a point easily by entering the following information: Navigation Aid 1, Radial 1, Navigation Aid 2, Radial 2.

<!--T:24-->
GVA, R100 , SCS, R300

<!--T:45-->
Of course you can use coordinates or bearings for the above command.

<!--T:46-->
[[File:98146.jpg]]


===Search by geocoded places=== <!--T:47-->
[[File:geocode.jpg|250px|caption|left]]It is also possible to search by place names. By acquiring our Add-on '''Streets and places search''' you will be able to search for places like hotels, bars, hospitals and much more points of interest in the database. You can then use these points as regular waypoints by adding them to routes or showing them on the map.








----
==Browse Database== <!--T:25-->
[[File:searchimage.jpg|right|caption|300px]]If you are not able to find the waypoint you are looking for, you can tap on "browse databade...". You can visualize quickly nearby waypoints or use the «search» tab to go search by country or search directly the waypoint you are looking for. It is possible to search by “name”, “ID” or “place”.
Once you found the desired waypoint, you can directly press on it
to select it as a “direct to” or adjust it to one of the instruments (HSI, VOR, ADF); or you can press on the blue disclosure button on the right side and check the information about it such as name, city, frequency (for Navaids), runway and contact frequency info (for Airfields) and you can center the waypoint  on the moving map by selecting «Show on map» button.

[[File:showonmap.jpg]]
----
==Create Waypoint via URL== <!--T:4-->
In order to help the workflow it is possible to quickly insert waypoints in the application by tapping on a specially formatted URL. The URL can be sent by E-Mail, SMS or browsed on a website.

<!--T:26-->
Supported actions:
* Direct-to
* Import waypoints to user database
* Create route

<!--T:27-->
The URL looks something like this:
Clean: airnavpro://direct-to?coordinates=wgs84-decimal&location=46.875_7.234,0.0,WP1,Grass field
Encoded query: airnavpro://direct-to?coordinates%3Dwgs84-decimal%26location%3D46.875_7.234%2C0.0%2CWP1%2CGrass%20field

<!--T:28-->
It consists of:
* URL scheme: airnavpro://
* An action: direct-to
* Coordinates format: coordinates=wgs84-decimal
* waypoint(s): location=46.875_7.234,0.0,WP1,Grass field
<br />
----
<u>'''Note:'''</u> The query part of the URL has to be URL encoded in order to support special characters.
----
<br />
Coordinates formats:
{|
|
* wgs84-ddmmss
* wgs84-decimal
* wgs84-ddmmdecimal
* utm-std
* utm-band
* ups
* mgrs100
* mgrs10
* mgrs1
|
* irish
* ir+zone
* nzgd1949
* nzgd2000
* swiss
* uk
* uk+zone
* rt90
* sweref99tm
|}

<!--T:29-->
Waypoint format
For any action the waypoint can be defined with different values separated by a comma (,). Waypoints are separated by semicolons (;).

<!--T:30-->
Waypoint values:
# Coordinates
# Elevation (in meters)
# Waypoint ID
# Waypoint name
<br />
A waypoint must at least contain the coordinates information. The coordinates information may be composed of two values, in this case the coordinates must be linked with a underscore (_). For example, a waypoint description for a wgs84 decimal format: 46.875_7.234

<!--T:31-->
Here is a full example with elevation, ID and name data: 46.875_7.234,0.0,WP1, Antenna

===Direct-to=== <!--T:32-->
Direct to can be achieved by formatting an URL with the "direct-to" command. Only one waypoint can be specified and it has to be in the form like :

<!--T:33-->
location=waypoint

<!--T:34-->
Here are some examples of direct-to URLs :

<!--T:35-->
WGS84 decimal
  - airnavpro://direct-to?coordinates=wgs84-decimal&location=46.875_7.234,0.0,WP1,Grass field

<!--T:36-->
WGS84 degrees minutes seconds
  - airnavpro://direct-to?coordinates=wgs84-ddmmss&location=N 12°34′56′′_W 78°12′34′′,0.0,WP1,Grass field

<!--T:37-->
Swissgrid CH1903
  - airnavpro://direct-to?coordinates=swiss&location=602030.68_191775.03,0.0,WP1,Zimmerwald

===Import waypoints to user database=== <!--T:38-->
A list of waypoints can be imported directly in the user database with a specially formatted URL with the "add-waypoints" command. A list of waypoints can be specified and it has to be in the form like :

<!--T:39-->
waypoints=point1;point2;point3

<!--T:40-->
Here is an example of add-waypoints URLs :
  - airnavpro://add-waypoints?coordinates=wgs84-decimal&waypoints=46.123_6.543,125.0,WP1,Grass field;47.113_7.143,225.1,WP2,Forrest;45.153_6.643,1225.0,WP3,Antenna

===Create Route=== <!--T:41-->
A new route with a list of waypoints can be created and loaded directly with a specially formatted URL with the "new-route" command. A route name and list of waypoints can be specified and it has to have a form like:
route-name=myRoute&waypoints=point1;point2;point3

<!--T:42-->
Here is an example of add-waypoints URLs :
  - airnavpro://new-route?coordinates=wgs84-decimal&route-name=myRoute&waypoints=46.123_6.543,125.0,WP1,Grass field;47.113_7.143,225.1,WP2,Forrest;45.153_6.643,1225.0,WP3,Antenna
----
<br />
Back to <u>[[Air Navigation iOS|index]]</u>
</translate>