Szablon:Mapa lokalizacyjna/opis
To jest podstrona dokumentacji dla strony Szablon:Mapa lokalizacyjna.
Zawiera ona informacje na temat użycia tej strony, jej kategoryzację i inną zawartość niebędącą częścią oryginalnej strony.
Szablon służy do automatycznego zaznaczania na mapie położenia miasta/wsi/góry etc.
Nazewnictwo szablonów przyjęte wg Wikipedia:Szablony krajów z flagami.
UWAGA: Istnieje możliwość zdefiniowania jednej mapy dla kilku terytoriów (na przykład w przypadku terytoriów spornych, ujętych na jednej mapie). Więcej na ten temat w opisie szablonu Sporne.
Do przeliczania współrzędnych punktów krańcowych ze stopni na decymalne przydaje się konwerter. Standardowe mapy muszą spełniać odwzorowanie walcowe równoodległościowe. Przykłady można znaleźć np. tutaj Free World Maps lub CIA The World Factbook.
Istnieje również oddzielny mechanizm dla odwzorowania azymutalnego równoodległościowego - zobacz Mapa lokalizacyjna++.
Mapy o innych odwzorowaniach są nie do skalibrowania przy obecnie zdefiniowanych mechanizmach.
[edytuj] Wywoływanie mapy lokalizacyjnej
Obecnie są dostępne mapy:
[edytuj] Tworzenie szablonów dla innych odzworowań kartograficznych
Szablon obliczający położenie znacznika na mapie lokalizacyjnej o odwzorowaniu innym niż walcowe równoodległościowe powinien posiadać następującą strukturę:
{{#fffff3: {{{współrzędna}}}
|x= --------> tu wpisać algorytm obliczający położenie znacznika na osi X w procentach szerokości mapy
|y= --------> tu wpisać algorytm obliczający położenie znacznika na osi Y w procentach wysokości mapy
|}}
Przykładowo wartości x=0 y=0 umiejscowią znacznik w lewym górnym rogu mapy, a x=50 y=50 w środku mapy.
Mapy lokalizacyjne powinny być definiowane na podstronach szablonu Mapa lokalizacyjna (zob. listę powyżej). Definicja map lokalizacyjnych powinna posiadać następującą strukturę:
{{#fffff3: {{{1}}}
|szablon_odwzorowania= -----> nazwa szablonu liczącego wartości x,y dla mapy o danym odwzorowaniu¹
|... \
|... --------------> dowolne definicje zmiennych kalibracyjnych (właściwe dla danego odwzorowania)
|... /
}}
¹Dla odwzorowania walcowego równoodległościowego parametr ten powinien być pusty!
[edytuj] Jak to działa?
Po wywołaniu szablonu mapy lokalizacyjnej (zob. Dyskusja szablonu:Mapa lokalizacyjna), szablon sprawdza, czy w definicji żądanej mapy zdefiniowano parametr szablon_odwzorowania. Jeśli parametr ten jest pusty (lub nie został zapisany), następuje obliczenie położenia znacznika według algorytmu dla odwzorowania walcowego równoodległościowego. Jeśli parametr ten nie jest pusty, szablon Mapa lokalizacyjna wysyła do szablonu o nazwie określonej tym parametrem zapytanie o wartości x i y, przekazując tam jednocześnie zmienne, wprowadzone przy wywołaniu mapy:
- 1 - szablon definicji mapy (z listy powyżej), jako pierwszy parametr ({{{1}}})
- szerokość_deg - stopnie szerokości geogr. miejsca na mapie
- szerokość_min - minuty szerokości geogr. miejsca na mapie
- szerokość_sec - sekundy szerokości geogr. miejsca na mapie
- szerokość_dir - szerokość geogr. miejsca na mapie (N lub S)
- długość_deg - stopnie długości geogr. miejsca na mapie
- długość_min - minuty długości geogr. miejsca na mapie
- długość_sec - stopnie długości geogr. miejsca na mapie
- długość_dir - długość geogr. w stopniach (E lub W)
- width - szerokość wyświetlanej mapy
- współrzędna - x lub y (zapytanie o wartość, która ma być zwrócona)
Jak wynika z powyższego nowy szablon powinien obługiwać powyższe nazwy zmiennych, wczytywać odpowiednie (właściwe dla tego odwzorowania) współrzędne kalibracyjne z szablonu Mapa lokalizacyjna/{{{1}}} oraz zwracać odpowiednią wartość (x lub y) w zależności od tego, czy parametr współrzędna posiada wartość "x" czy "y". Na podstawie zwróconych wartości szablon Mapa lokalizacyjna umiejscawia znacznik w odpowiednim położeniu na grafice mapy.
[edytuj] Zobacz też
|