PmWiki | Cookbook / Geobox

Summary: Create links to various map sites from provided gps coordinates.

Version: 2011-10-05

Prerequisites:

Status:

Maintainer: Anomen

Users: (View ? / Edit ?)

Categories: Links

Discussion: Geobox-Talk ?

Questions answered by this recipe

How to automatically create links for given gps coordinates to various map sites.

Description

Recipe creates links to various map sites from provided gps coordinates.

Installation

Download geobox.php Δ.

In config.php, add the following line:

 include_once("$FarmD/cookbook/geobox.php");

Usage

Use geobox markup (:geo 49°43.996 14°27.665 :)

to create link list:

 49°43.996' 014°27.665 mapy.cz gmaps geocaching.com/maps geocaching.com/near

Coordinate input format

Coordinates consists of latitude and logitude values separated by space character(s).
Values can pre prefixed or postfixed with N or S for lat. and E or W for lon.
Decimal dot or coma can be used.
several characters can be used as degree sign (U+002A ASTERISK, U+00B0 DEGREE SIGN, U+00BA MASCULINE ORDINAL INDICATOR', U+02DA RING ABOVE'').
all three formats are recognised (degrees only and mixed formats with arcmin or arcmin+arcsec)
degree sign is mandatory only for mixed formats (to separate degrees and arcminutess)

Coordinate display format

You can change format of displayed coordinates by using format paremater.

Possible values and meanings are:

D: deg°
M: deg°min'
S: deg°min'sec"

For example, following line will produce coordinates displayed as degrees: (:geo format=d 49°43.996 14°27.665 :)

Point projection

You can perform point projection using parameters azimuth (value in degrees) and distance (value in meters). Result of projection will be displayed (together with proper links) instead of original given coordinates.

For example, following line will produce coordinates 50.00949 15.18703 :

(:geo format=d azimuth=45 distance=2703 49.99232 15.16031 :)

Configuration

Map sites

You can modify list of links be changing $GeoBoxLinks array.

disable list: $GeoBoxLinks = array();
remove link: unset($GeoBoxLinks['mapy.cz']);
add link: SDVA($GeoBoxLinks, array('title'=>'http://example.com/maps'));
replace list: $GeoBoxLinks = array('title'=>'http://example.com/maps');

In link address you can use these variables (prefixed by $ sign):

LAT: hemisphere N / S
N: latitude
S: -latitude
Nd: latitude (absolute value)
Ni: latitude (integer part only)
Ndi: latitude (absolute value, integer part only)
NSig: sign for N (empty for north, - for south)
Nm: minutes of N (absolute value)
Nmi: minutes of N (absolute value, integer part only)
Ns: : seconds of N (absolute value)
Nsi: seconds of N (absolute value, integer part only)
LON: hemisphere E / W
E: longitude - all values analogical to latitude
W
Ed
Ei
Edi
ESig
Em
Emi
Es
Esi

Note: Either apostrophes must be used as string delimiters instead of double quotes or proper $ escaping must be used to avoid expanding of variables by PHP.

Example

print coordinates and link to google maps

 include_once("$FarmD/cookbook/geobox.php");
 $GeoBoxLinks = array('maps.google.com'=>'http://maps.google.com/?q=$N%20$E');

add link to mapquest.com

 include_once("$FarmD/cookbook/geobox.php");
 SDVA($GeoBoxLinks,  array('mapquest'=>'http://www.mapquest.com/?q=$N,$E&amp;zoom=15'));

Change log / Release notes

2010-06-12 - added to PmWiki Cookbook
2011-08-22 - point projection, configurable link list and various improvements
2011-10-05 - utf8 handling, various fixes

Contributors

Anomen (original author)

Comments

See discussion at Geobox-Talk ?.

User notes ? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.

Geobox