Geobox

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

Version: 2024-08-30

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 and unpack geobox-2024-08-30.zip Δ.

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 longitude 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 different characters can be used as degree sign ( * ° ˚ º ). This simplifies usage across various keyboard layouts. Note: PmWiki must be setup to use Unicode.
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"
G: N/W/E/S deg°min'

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 :)

or shortly:

(:geo f=d a=45 d=2703 49.99232 15.16031 :)

Configuration

Map sites

You can modify list of links by 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');

You can also use $GeoBoxIcons variable to use show icon instead of label. Images must be stored in pub/geobox folder.

By default, icons are displayed, instead of service name. If you want to switch back to text labels use:

 unset($GeoBoxIcons);

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, which will be displayed as an icon (you have to provide /pub/geobox/mapquest.png)

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

Change log / Release notes

2024-08-30 - support icons
2021-10-26 - update for PHP 8
2016-01-13 - fixed compatibility with PHP 5.5
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

ToDo

add support for Wikipedia:Geo_URI

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.