Geocode function

From Maps for MediaWiki
Revision as of 23:34, 7 May 2020 by Jeroen De Dauw (talk | contribs) (Created page with "The Maps extension supports geocoding at all places where you can specify a location. You can access this functionality directly using the <code>#geocode</code> parser fun...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The Maps extension supports geocoding at all places where you can specify a location. You can access this functionality directly using the #geocode parser function, which gives you the coordinates for the address you provide to it.

Syntax

{{#geocode:<your address>|format=<coordinate format>|directional=<yes/no>}}

Usecases

You can use #geocode inline with some text or in an infobox.

The Brandenburg Gate is in Berlin at {{#geocode:Brandenburg Gate}}

Result: The Brandenburg Gate is in Berlin at 52° 30' 58.57" N, 13° 22' 39.73" E

Another common use case is to store coordinates in SMW using the coordinate data type, so they can be queried.

[[Has coordinates::{{#geocode: Brandenburg Gate}}]]

Parameters

Parameter Default Usage
location required The address you want to geocode.
format dms (changeable in wiki config with egMapsCoordinateNotation) The format to convert the coordinates to. See available coordinate formats
directional yes (changeable in wiki config with egMapsCoordinateDirectional) Indicates if the coordinates should be outputted directional or not. Must be either yes or no.

Examples

Basic syntax

{{#geocode:New York}}

Result: 40° 42' 45.82" N, 74° 0' 21.65" W

Specifying the output coordinate format

{{#geocode:location=New York City|format=float|directional=no}}

Result: 40.712728, -74.006015

{{#geocode:New York City|format=dms|directional=yes}}

Result: 40° 42' 45.82" N, 74° 0' 21.65" W

Passing along coordinates

This is to show that if you have a dynamic value that can be either an address or a set of coordinates, you can safely pass it to the #geocode parser function. If you want to convert coordinates into a different format, it is better to use the #coordinates parser function.

{{#geocode:40.7142691, -74.0059729}}

Result: 40° 42' 51.37" N, 74° 0' 21.50" W