Embed Maps: Difference between revisions

From WikiMLT
 
(8 intermediate revisions by the same user not shown)
Line 8: Line 8:


=== Installation ===
=== Installation ===
If you are using MediaWiki 1.35 or later and PHP 7.4 or later, run the following two commands.<syntaxhighlight lang="shell" line="1">
If you are using MediaWiki 1.35 or later and PHP 7.4 or later, run the following two commands.
IP="/var/www/wiki.example.com"
<syntaxhighlight lang="shell" line="1" class="code-continue mlw-shell-gray">
OWNER="www-data"
: ${IP:="/var/www/wiki.example.com"} # The DocumentRoot directory of the wiki
</syntaxhighlight><syntaxhighlight lang="shell" line="1">
: ${OWNER:="www-data"}              # The user that owns the $IP directory
: ${BRANCH:="REL1_38"}              # The MediaWiki's branch in use
</syntaxhighlight>
<syntaxhighlight lang="shell" line="1">
cd "$IP"
cd "$IP"
sudo -u "$OENER" COMPOSER=composer.local.json composer require --no-update mediawiki/maps:~9.0
sudo -u "$OENER" COMPOSER=composer.local.json composer require --no-update mediawiki/maps:~9.0
Line 22: Line 25:
  */
  */
wfLoadExtension( 'Maps' );
wfLoadExtension( 'Maps' );
</syntaxhighlight>For more details see the installation tab on the home page.
</syntaxhighlight>For more details and ow to use Google maps instead of Leaflet maps read the [https://maps.extension.wiki/wiki/Installation installation manual].
 
=== Obtain GeoJson data ===
More details can be can be found in the section [https://maps.extension.wiki/wiki/Leaflet_GeoJSON Leaflet GeoJSON] at the documentation. Here is decried one approach how to obtain (polygon coordinates in JSON) GeoJson, provided within the answers of the question [https://gis.stackexchange.com/a/192298/212523 Getting polygon boundaries of City in JSON from Google Maps API?]:
 
'''1.'''  Go to https://nominatim.openstreetmap.org/.
 
'''2.''' In the search bar type the name of the area, like [https://nominatim.openstreetmap.org/ui/search.html?q=Sofia-City+Bulgaria "Sofia-City Bulgaria"].
 
'''3.''' Shen click on the [https://nominatim.openstreetmap.org/ui/details.html?osmtype=R&osmid=1739543&class=boundary details] button for the location.
 
'''4.''' Find the entry [https://www.openstreetmap.org/relation/1739543 OSM] for the location and copy the Id, i.e. <code>1739543</code>. Don't click at the link just copy the Id.
 
'''5.''' Go to [https://polygons.openstreetmap.fr/index.py https://polygons.openstreetmap.fr/] and past the If in the field "Id relation" and press the Submit button.
 
'''6.''' At the page [https://polygons.openstreetmap.fr/?id=1739543 List of available polygons for id = 1739543] click on the link [https://polygons.openstreetmap.fr/get_geojson.py?id=1739543&params=0 GeoJSON] within the table.
 
== Usage samples ==
For more details read the the documentation provided at the Maps for MediaWiki's [https://maps.extension.wiki/wiki/Maps_for_MediaWiki homepage].
 
=== Sofia ===
<syntaxhighlight lang="html+handlebars">
{{#display_map: Mladost 4, Sofia, Bulgaria }}
</syntaxhighlight>{{#display_map: Mladost 4, Sofia, Bulgaria | geojson= }}<syntaxhighlight lang="html+handlebars">
{{#display_map: center=Sofia, Bulgaria | geojson=Sofia}}
</syntaxhighlight>{{#display_map:center=Sofia, Bulgaria| geojson=Sofia}}
 
* GeoJson in use: [[GeoJson:Sofia]]


== References ==
=== Berlin ===
<syntaxhighlight lang="html+handlebars">
{{#display_map: center=Berlin | geojson=Berlin }}
</syntaxhighlight>{{#display_map: center=Berlin | geojson=Berlin}}


* ...
* GeoJson in use: [[GeoJson:Berlin]]


* ...


<noinclude>
<noinclude><div id='devStage'>
<div id='devStage'>
{{devStage  
{{devStage  
  | Прндл  = WikiMLT Features
  | Прндл  = WikiMLT Features
  | Стадий = 3
  | Стадий = 6
  | Фаза  = Разработване
  | Фаза  = Утвърждаване
  | Статус = Разработван
  | Статус = Утвърден
  | ИдтПт  = Spas
  | ИдтПт  = Spas
  | РзбПт  = {{REVISIONUSER}}
  | РзбПт = Spas
| АвтПт  = Spas
| УтвПт = {{REVISIONUSER}}
  | ИдтДт  = 27.09.2022
  | ИдтДт  = 27.09.2022
  | РзбДт  = {{Today}}
  | РзбДт = 27.09.2022
| АвтДт  = 27.09.2022
| УтвДт = {{Today}}
  | ИдтРв  = [[Special:Permalink/32005|32005]]
  | ИдтРв  = [[Special:Permalink/32005|32005]]
  | РзбРв  = {{REVISIONID}}
  | РзбРв = [[Special:Permalink/32019|32019]]
| АвтРв  = [[Special:Permalink/32020|32020]]
| УтвРв = {{REVISIONID}}
}}
}}
</div>
</div>
</noinclude>
</noinclude>

Latest revision as of 00:16, 28 September 2022

Exension:Maps

In­stal­la­tion

If you are us­ing Me­di­aWi­ki 1.35 or lat­er and PHP 7.4 or lat­er, run the fol­low­ing two com­mands.

: ${IP:="/var/www/wiki.example.com"} # The DocumentRoot directory of the wiki
: ${OWNER:="www-data"}               # The user that owns the $IP directory
: ${BRANCH:="REL1_38"}               # The MediaWiki's branch in use
cd "$IP"
sudo -u "$OENER" COMPOSER=composer.local.json composer require --no-update mediawiki/maps:~9.0
sudo -u "$OENER" composer update mediawiki/maps --no-dev -o
sudo nano "${IP}/LocalSettings.php"
/**
 * Extension:Maps, https://maps.extension.wiki/wiki/Installation
 */
wfLoadExtension( 'Maps' );

For more de­tails and ow to use Google maps in­stead of Leaflet maps read the in­stal­la­tion man­u­al.

Ob­tain Geo­J­son da­ta

More de­tails can be can be found in the sec­tion Leaflet Geo­J­SON at the doc­u­men­ta­tion. Here is de­cried one ap­proach how to ob­tain (poly­gon co­or­di­nates in JSON) Geo­J­son, pro­vid­ed with­in the an­swers of the ques­tion Get­ting poly­gon bound­aries of City in JSON from Google Maps API?:

1. Go to https://​nominatim​.openstreetmap​.org/.

2. In the search bar type the name of the area, like "Sofia-City Bul­gar­ia".

3. Shen click on the de­tails but­ton for the lo­ca­tion.

4. Find the en­try OSM for the lo­ca­tion and copy the Id, i.e. 1739543. Don't click at the link just copy the Id.

5. Go to https://​polygons​.openstreetmap​.fr/ and past the If in the field "Id re­la­tion" and press the Sub­mit but­ton.

6. At the page List of avail­able poly­gons for id = 1739543 click on the link Geo­J­SON with­in the ta­ble.

Us­age sam­ples

For more de­tails read the the doc­u­men­ta­tion pro­vid­ed at the Maps for MediaWiki's home­page.

Sofia

{{#display_map: Mladost 4, Sofia, Bulgaria }}

{{#display_​​​map: Mla­dost 4, Sofia, Bul­gar­ia | geo­j­son= }}

{{#display_map: center=Sofia, Bulgaria | geojson=Sofia}}

{{#display_map:center=Sofia, Bul­gar­ia| geojson=Sofia}}

Berlin

{{#display_map: center=Berlin | geojson=Berlin }}

{{#display_​​​map: center=Berlin | geojson=Berlin}}