Finddestination

From Mapping on MediaWiki
Jump to: navigation, search
Finddestination
What:
Finds the destination given a starting point, initial bearing and a distance
Min version:
0.6
Max version:
still supported
Function implementation:
Yes
Tag implementation:
Yes


You can use the #finddestination parser function to find a destination given a starting point(that can be in any of the supported formats), an initial bearing and a distance. This function is part of the Maps extension, so you should have Maps installed in order to use it.

Usage

Syntax

{{#finddestination:{starting point}|{initial bearing}|{distance}}}

Parameters

This parser function supports use of so called 'default parameters'. This allows you to simply pass along values, without writing the parameter name= part. You can mix this notation together with using named parameters, but must at all times keep the default ones in the correct order.

Parameter Aliases Default Usage
location - required The initial location.
bearing - required The initial bearing.
distance - required The distance to travel
format notation configurable The format in which to output the destination.
directional - configurable Indicates if the format of the destination should be directional or not. Either yes or no.
allowcoordinates - configurable Indicates if coordinates should be allowed. If set to no, only addresses will be accepted.
service - configurable The geocoding service to use to geocode the value in case it's an address.
mappingservice - none Parameter you can use to indicate the mapping service you are using this function with. This will maps allow to override the default value of the service parameter by the one that's optimal for the mapping service. (Example: In case of Google Maps, the Google geocoder will be used.)

Examples

Calculating the distance between two points

{{#finddestination:55.7557860° N, 37.6176330° W|90|500}}

Results into: 55° 45' 21" N, 37° 36' 35" W

{{#finddestination:New York|bearing=90|distance=500|format=float}}

Results into: 40.7127835482 N, 74.000009012 W

See also

This documentation page applies to all (Semantic) Maps versions from 0.7 to the most current version.
Other versions: 0.6 – 0.6.6      

Finddestination en 0.7

Facts about "Finddestination"RDF feed
From version0.7 +
Has descriptionFinds the destination given a starting point, initial bearing and a distance +
Has maximum versionstill supported +
Has minimum version0.6 +
Has parser functiontrue +
Has tag extensiontrue +
Is master pagetrue +
Language codeen +
Master pageFinddestination +