Module:OSM/doc - Revision history

KelleyCook: /* Wikidata */ fix link to actual page not the proposal

2022-12-22T04:05:30Z

Wikidata: fix link to actual page not the proposal

← Previous revision		Revision as of 04:05, 22 December 2022
Line 12:		Line 12:
	Luckily Wikidata came along and this forms a part of the puzzle that can help solve this problem. What we can do is add tags which refer back to Wikidata items on the Openstreetmap side.		Luckily Wikidata came along and this forms a part of the puzzle that can help solve this problem. What we can do is add tags which refer back to Wikidata items on the Openstreetmap side.

	[https://wiki.openstreetmap.org/wiki/~~Proposed_features/Wikidata~~ wikidata tag]		[https://wiki.openstreetmap.org/wiki/Key:wikidata wikidata tag]

	Now if a way is split, both parts will continue with the proper wikidata tag.		Now if a way is split, both parts will continue with the proper wikidata tag.

Jc86035: HTTPS for OpenStreetMap wiki (via WP:JWB)

2018-12-06T11:27:21Z

HTTPS for OpenStreetMap wiki (via WP:JWB)

← Previous revision		Revision as of 11:27, 6 December 2018
Line 12:		Line 12:
	Luckily Wikidata came along and this forms a part of the puzzle that can help solve this problem. What we can do is add tags which refer back to Wikidata items on the Openstreetmap side.		Luckily Wikidata came along and this forms a part of the puzzle that can help solve this problem. What we can do is add tags which refer back to Wikidata items on the Openstreetmap side.

	[~~http~~://wiki.openstreetmap.org/wiki/Proposed_features/Wikidata wikidata tag]		[https://wiki.openstreetmap.org/wiki/Proposed_features/Wikidata wikidata tag]

	Now if a way is split, both parts will continue with the proper wikidata tag.		Now if a way is split, both parts will continue with the proper wikidata tag.
Line 19:		Line 19:
	But now we have a new problem. How to find those elements in the Openstreetmap DB, which got wikidata tags assigned to them?		But now we have a new problem. How to find those elements in the Openstreetmap DB, which got wikidata tags assigned to them?

	Well there is a tool to help with this. It has the whole database of Openstreetmap, updated on a minutely basis and it's fast to query, on condition the queries can be kept simple. It's called [~~http~~://wiki.openstreetmap.org/wiki/Overpass_API Overpass API].		Well there is a tool to help with this. It has the whole database of Openstreetmap, updated on a minutely basis and it's fast to query, on condition the queries can be kept simple. It's called [https://wiki.openstreetmap.org/wiki/Overpass_API Overpass API].

	===Overpass Turbo===		===Overpass Turbo===
	Looking at raw data, is not very instructive either, so another tool was built around it, which is called [~~http~~://wiki.openstreetmap.org/wiki/Overpass_turbo Overpass Turbo].		Looking at raw data, is not very instructive either, so another tool was built around it, which is called [https://wiki.openstreetmap.org/wiki/Overpass_turbo Overpass Turbo].

	===Query===		===Query===

Polyglot: rewrite a little

2015-08-19T05:32:58Z

rewrite a little

← Previous revision		Revision as of 05:32, 19 August 2015
Line 3:		Line 3:
	== Goal ==		== Goal ==

	On this page [[Wikipedia:WikiProject_OpenStreetMap]] it becomes clear different approaches have been tried before to link from Wikipedia to Openstreetmap~~. Both are projects where freely available content are created, so working together seems like a great idea~~.		On this page [[Wikipedia:WikiProject_OpenStreetMap]] it becomes clear different approaches have been tried before to link from Wikipedia to Openstreetmap.

	But why is this so hard? Well, there are a few problems, one of them is that ids for nodes, ways and relations on Openstreetmap are not guaranteed to be stable. When ways are split the id will point to a shorter stretch and the other part will get a new id. Sometimes points of interest which start as nodes, are converted to (closed) ways. Some contributors delete items, which get recreated by them a bit further along. Or somebody notices it's missing and recreates it fresh.		But why is this so hard? Well, there are a few problems, one of them is that ids for nodes, ways and relations on Openstreetmap are not guaranteed to be stable. When ways are split the id will point to a shorter stretch and the other part will get a new id. Sometimes points of interest which start as nodes, are converted to (closed) ways. Some contributors delete items, which get recreated by them a bit further along. Or somebody notices it's missing and recreates it fresh.

	So pointing directly to the OSM objects themselves doesn't ~~really~~ work all that well. Let's say it's not future proof. It may work at the moment you define the link and a good while after, or it may fail the next day already.		So pointing directly to the OSM objects themselves doesn't work all that well. Let's say it's not future proof. It may work at the moment you define the link and a good while after, or it may fail the next day already.

	===Wikidata===		===Wikidata===
Line 14:		Line 14:
	[http://wiki.openstreetmap.org/wiki/Proposed_features/Wikidata wikidata tag]		[http://wiki.openstreetmap.org/wiki/Proposed_features/Wikidata wikidata tag]

	Now if an way is split, both parts will continue with the proper wikidata tag.		Now if a way is split, both parts will continue with the proper wikidata tag.

	===Overpass API===		===Overpass API===
	But now we have a new problem: ~~how~~ to find those elements in Openstreetmap, which got wikidata tags assigned to them?		But now we have a new problem. How to find those elements in the Openstreetmap DB, which got wikidata tags assigned to them?

	Well there is a tool to help with this. It has the whole database of Openstreetmap, updated on a minutely basis and it's fast to query, on condition the queries can be kept simple. It's called [http://wiki.openstreetmap.org/wiki/Overpass_API Overpass API].		Well there is a tool to help with this. It has the whole database of Openstreetmap, updated on a minutely basis and it's fast to query, on condition the queries can be kept simple. It's called [http://wiki.openstreetmap.org/wiki/Overpass_API Overpass API].
Line 25:		Line 25:

	===Query===		===Query===
	What this module does for you, is to ~~create~~ a query that works, with sensible default values~~, so you have to give the least parameters possible~~.		Developing these queries takes some trial and error. What this module does for you, is to automate the process and come up with a query that works, with sensible default values.

	For example if you omit the Wikidata id, the id of the corresponding article will be used.		For example if you omit the Wikidata id, the id of the corresponding article will be used.

	But it's also possible to write your own custom queries, or to specify further filters. Normally all objects types, nodes, ways and relations will be fetched, but it's possible to limit to only ways, for example.		But it's also possible to write your own custom queries, or to specify further filters. Normally all objects' types, nodes, ways and relations will be fetched, but it's possible to limit to only ways, for example.

	===in style===		===in style===

Polyglot: expand documentation

2015-08-18T22:24:28Z

expand documentation

@@ Line 1: / Line 1: @@
 {{Module rating |beta}}
 == Usage ==
@@ Line 33: / Line 65: @@
 * limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox
 * run        : defaults to yes. Use no if you want the user to be able to move the map or change the query before searching
-* style      : it's possible to define a MapCSS style to presenet the result in a nicer way
+* style      : it's possible to define a MapCSS style to present the result in a nicer way
 == Test values  ==

Polyglot: added a new method and the possiblity to define a MapCSS style

2015-08-15T06:43:55Z

added a new method and the possiblity to define a MapCSS style

← Previous revision		Revision as of 06:43, 15 August 2015
Line 3:		Line 3:
	== Usage ==		== Usage ==

			* Search Openstreetmap independently of wikidata tags
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''overpass''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''overpass''}}
	* Search Openstreetmap ~~independently~~ of ~~wikidata~~ ~~tags~~		* Search Openstreetmap for items which have wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''wd''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''wd''}}
	* Search Openstreetmap for items which have wikidata=Q....		* Search Openstreetmap for items which have name:etymology:wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''etym''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''etym''}}
	* Search Openstreetmap for items which have ~~name:etymology~~:wikidata=Q....		* Search Openstreetmap for items which have subject:wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''subject''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''subject''}}
	* Search Openstreetmap for items which have ~~subject~~:wikidata=Q....		* Search Openstreetmap for items which have artist:wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''artist''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''artist''}}
			* Search Openstreetmap for items which have architect:wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''architect''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''architect''}}
			* Search Openstreetmap for items which have operator:wikidata=Q....
⚫	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''~~subject~~''}}
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''operator''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''operator''}}
			* Search Openstreetmap for items which have brand:wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''brand''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''brand''}}
			* Search Openstreetmap for public transport lines related to the current article
		⚫	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''pt''}}

	===Parameters===		===Parameters===
Line 28:		Line 33:
	* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox		* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox
	* run : defaults to yes. Use no if you want the user to be able to move the map or change the query before searching		* run : defaults to yes. Use no if you want the user to be able to move the map or change the query before searching
			* style : it's possible to define a MapCSS style to presenet the result in a nicer way

	== Test values ==		== Test values ==

Polyglot: add doc for timeout value

2015-08-14T17:18:09Z

add doc for timeout value

← Previous revision		Revision as of 17:18, 14 August 2015
Line 21:		Line 21:
	* display : Text shown on outgoing link		* display : Text shown on outgoing link
	* link : defaults to yes, but can be set to no for use in other templates		* link : defaults to yes, but can be set to no for use in other templates
			* timeout : defaults to 15 seconds, needs to be set higher for more complicated queries
	* id : can link to a 1 or more Q-numbers of wikidata items, defaults to the Q-number id of the calling page		* id : can link to a 1 or more Q-numbers of wikidata items, defaults to the Q-number id of the calling page
	* query : makes it possible to extend the query, which can be used to limit the search to highways or tombstones		* query : makes it possible to extend the query, which can be used to limit the search to highways or tombstones
	* prim : ~~specifies to~~ only fetch '''n'''ode, '''w'''ay and/or '''r'''elation primitives		* prim : only fetch '''n'''ode, '''w'''ay and/or '''r'''elation primitives
	* coord : coordinates and a zoom factor in this format: '''47.0618984;15.4370248;17''' from which a bbox will be determined.		* coord : coordinates and a zoom factor in this format: '''47.0618984;15.4370248;17''' from which a bbox will be determined.
	* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox		* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox

Polyglot at 07:12, 6 August 2015

2015-08-06T07:12:48Z

← Previous revision		Revision as of 07:12, 6 August 2015
Line 3:		Line 3:
	== Usage ==		== Usage ==

⚫	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''wd''}}
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''overpass''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''overpass''}}
			* Search Openstreetmap independently of wikidata tags
		⚫	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''wd''}}
			* Search Openstreetmap for items which have wikidata=Q....
	<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''etym''}}		<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''etym''}}
			* Search Openstreetmap for items which have name:etymology:wikidata=Q....
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''subject''}}
			* Search Openstreetmap for items which have subject:wikidata=Q....
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''artist''}}
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''architect''}}
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''subject''}}
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''operator''}}
			<nowiki>{{</nowiki>#invoke:{{BASEPAGENAME}}\|''brand''}}

	===Parameters===		===Parameters===
Line 16:		Line 26:
	* coord : coordinates and a zoom factor in this format: '''47.0618984;15.4370248;17''' from which a bbox will be determined.		* coord : coordinates and a zoom factor in this format: '''47.0618984;15.4370248;17''' from which a bbox will be determined.
	* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox		* limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox
			* run : defaults to yes. Use no if you want the user to be able to move the map or change the query before searching

	== Test values ==		== Test values ==

Polyglot at 23:04, 5 August 2015

2015-08-05T23:04:20Z

← Previous revision		Revision as of 23:04, 5 August 2015
Line 19:		Line 19:
	== Test values ==		== Test values ==

	{{#invoke:OSM/testcases\|~~test_etym~~}}		{{#invoke:OSM/testcases\|run_tests}}
	{{#invoke:OSM/testcases\|test_wd}}

	<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox \| \|		<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox \| \|

Polyglot: attempt to run unit tests

2015-08-05T21:51:38Z

attempt to run unit tests

← Previous revision		Revision as of 21:51, 5 August 2015
Line 19:		Line 19:
	== Test values ==		== Test values ==

	{{#invoke:OSM/~~tests~~\|~~run~~}}		{{#invoke:OSM/testcases\|test_etym}}
			{{#invoke:OSM/testcases\|test_wd}}

	<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox \| \|		<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox \| \|

Polyglot: replace unit test cases

2015-08-05T21:46:14Z

replace unit test cases

@@ Line 17: / Line 17: @@
 * limitToBBOX: defaults to yes. If coord is set the query is limited to the resulting bbox
-== Test values [[Module:OSM]] ==
+== Test values  ==
 <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |