Шаблён:GeoTemplate/Дакумэнтацыя
Шаблён {{GeoTemplate}} звычайна загружаецца пры выкарыстаньні шаблёнаў з геаграфічнымі каардынатамі. Зьнешняя прылада запаўняе шаблён зьвесткамі пра каардынаты чынам, як гэта апісана ніжэй на гэтай старонцы.
Парамэтры[рэдагаваць крыніцу]
GeoHack (прылада, якая запаўняе {{GeoTemplate}} працоўнымі спасылкамі) прымае два ўваходныя фарматы:
- Парамэтры ў адрасе: каардынаты перадаюцца ў фармаце Г_Х_С_N_Г_Х_С_E, Г_Х_N_Г_Х_E, Г_N_Г_E, або Г;Г дзе Г — значэньне градусаў, Х — значэньне хвілінаў, С — значэньне сэкундаў, і NS/EW абазначаюць паўшар’і: N — паўночнае, S — паўднёвае, E — усходняе, W — заходняе. Пасьля іх могуць знаходзіцца дадатковыя парамэтры, такія як тып мясцовасьці (апісаны ніжэй), маштаб і рэгіён, падзеленыя сымбалямі ніжняга падкрэсліваньня. У Вікіпэдыі адрас генэруецца аўтаматычна шаблёнамі каардынатаў.
Напрыклад, вікітэкст{{coord|51|28|40|N|0|0|6|W|type:landmark_scale:2000_region:GB}}пераўтвараецца ўparams=51_28_40_N_0_0_6_W_type:landmark_scale:2000_region:GBу адрасе. - Старонка шаблёну (зьмесьціва {{GeoTemplate}}), дзе зьменныя замяняюцца значэньнямі, якія вылічаюцца з інфармацыі, перададзенай у адрасе. Рэшта гэтай старонкі апісвае даступныя зьменныя.
Пазыцыя[рэдагаваць крыніцу]
GeoHack прадастаўляе наступны зьменныя, заснаваныя на перададзеных каардынатах(51_28_40_N_0_0_6_W, як у прыклыдзе вышэй).
- {ch1903easting}, {ch1903northing} — Швайцарская сыстэма каардынатаў — каардынаты CH1903+.
- {latdegabs}, {londegabs} — Сусьветная геадэзічная сыстэма — WGS84 — абсалютнае цэлае значэньне градусаў
- {latdegdec}, {londegdec}, {londegneg} — Сусьветная геадэзічная сыстэма — WGS84 — усяго дзесятковых градусаў
- {latdegint}, {londegint} — Сусьветная геадэзічная сыстэма — WGS84 — цэлы лік градусаў, акруглены да адмоўнай бясконцасьці
- {latdeground}, {londeground} — Сусьветная геадэзічная сыстэма — WGS84 — акруглены лік градусаў
- {latmindec}, {lonmindec} — Сусьветная геадэзічная сыстэма — WGS84 — дзесятковыя хвіліны
- {latminint}, {lonminint} — Сусьветная геадэзічная сыстэма — WGS84 — цэлыя хвіліны
- {latNS}, {lonEW} — Сусьветная геадэзічная сыстэма — WGS84 — кірунак абсалютных цэлых каардынатаў
- {latsecdec}, {lonsecdec} — Сусьветная геадэзічная сыстэма — WGS84 — дзесятковыя сэкунды
- {latsecint}, {lonsecint} — Сусьветная геадэзічная сыстэма — WGS84 — цэлыя сэкунды
- {nztmeasting}, {nztmnorthing} — папярочныя мэркатарскія каардынаты Новай Зэляндыі
- {osgb36ref} — Брытанская нацыянальная сыстэма каардынатаў, спасылка на сетку
- {utmnorthing} {utmeasting} {utmzone} — унівэрсальныя папярочныя мэркатарскія каардынаты
- {osgb36northing}, {osgb36easting}
- {utm33northing}, {utm33easting}
Маштаб[рэдагаваць крыніцу]
GeoHack падтрымлівае выкарыстаньне парамэтра scale (маштаб) parameter (scale:2000 у прыкладзе, прыведзеным вышэй), які ён выкарыстоўвае для прадастаўлення значэньняў маштабу альбо павелічэньня для разнастайных сэрвісаў мапаў
| назва | выкарыстоўваецца | формула вылічэньня |
|---|---|---|
| {scale} | Virtual Globe | прадастаўляецца ў адрасе праз scale альбо вылічаецца з значэньня type |
| {mmscale} | Multimap | бліжэйшае значэньне маштабу, якое дапускаецца Multimap (глядзіце mapsources.php) |
| {span} | Google Maps, WikiMapia | scale * 1.0 / 1,000,000 |
| {altitude} | MSN Maps, Fourmilab, Swissinfo | scale * 143 / 1,000,000 |
| {zoom} | MapQuest, Gule Sider | integer(18.0 - log(scale)) |
| {osmzoom} | OpenStreetMap, Live Search Maps | 18 - ( round(log($attr['scale'],2) - log(1693,2)) ) |
GeoHack дапушчае выкарыстаньне парамэтра type (тып) (type:landmark у прыкладзе вышэй), зь якога ён вылічвае значэньне парамэтру scale (маштаб), калі значэньне для яго не прадастаўленае. Наступная табліца паказвае тыпы, якія карэктна ўспрымаюцца GeoHack, значэньне маштабу, асацыяванае з кожным тыпам і дадатковыя зьменныя, якая вылічаюцца GeoHack.
| type (тып) | ratio (адносіна) | {scale} (маштаб) | {mmscale} | {span} | {altitude} | {zoom} (павелічэньне) | {osmzoom} |
|---|---|---|---|---|---|---|---|
| country (краіна) | 1 : 10,000,000 | 10000000 | 10000000 | 10 | 1430 | 1 | 5 |
| state (штат) | 1 : 3,000,000 | 3000000 | 4000000 | 3 | 429 | 3 | 7 |
| adm1st (адм. адзінка 1) | 1 : 1,000,000 | 1000000 | 1000000 | 1 | 143 | 4 | 9 |
| adm2nd (адм. адзінка 2) (значэньне па змоўчаньні) |
1 : 300,000 | 300000 | 200000 | 0.3 | 42 | 5 | 11 |
| city (горад), mountain (гара), isle (востраў) | 1 : 100,000 | 100000 | 100000 | 0.1 | 14 | 6 | 12 |
| airport (аэрапорт) | 1 : 30,000 | 30000 | 25000 | 0.03 | 4 | 7 | 14 |
| landmark (аб’ект мясцовасьці) | 1 : 10,000 | 10000 | 10000 | 0.01 | 1 | 8 | 15 |
Значэньні маштабу па змоўчаньні для кожнага значэньня тыпу type могуць быць зьмененыя дадатковым прадастаўленьнем значэньня маштабу празь зьменную scale. Напрыклад, type:airport выкарыстоўвае {scale} (маштаб), роўны 30000, у той час калі type:airport_scale:10000 выкарыстоўвае {scale} (маштаб), роўны 10000.
Падрабязнасьсі рэалізацыі можна ўбычыць ў выточным кодзе mapsources.php
Дадатковыя парамэтры[рэдагаваць крыніцу]
- {region}, {globe}, {page} - патрэбныя для загрузкі старонкі зь Вікіпэдыі. Таксама можа быць пазначаная падстаронка
- {pagename} — значэньне ключа pagename (назва старонкі) у запыце (напрыклад, &pagename=Article).
- {title} — значэньне ключа title (назва) у запыце (напрыклад, &title=Name). Калі не зададзеная ў запыце, выкарыстоўваецца такое ж значэньне, як і для {pagename}.
Кадаваньне сэкцыяў[рэдагаваць крыніцу]
Калі GeoHack высьвятляе, што парамэтры ўтрымліваюць назву рэгіёна з каардынатамі, сэкцыя зь сьпісам мапаў для гэтай краіны перамяшчаецца ўверх старонкі. Месца, дзе будзе зьмешчаная гэта сэкцыя пазначаецца наступным запаўняльнікам:
<div id="GEOTEMPLATE-LOCAL" />
Сэкцыі рэгіёнаў уключаныя ў асобны элемэнт, дзе XX у парамэтры зьяўляецца кодам ISO 3166-1 alpha-2:
<div id="GEOTEMPLATE-XX">
...
</div>