Дидани манбаъи Шаблон:Great circle distance/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
== Usage ==
Computes the [[great circle distance]] between two points, specified by the latitude and longitude, using the [[haversine formula]].

{{tlx|Great circle distance|''latitude 1''|''longitude 1''|''latitude 2''|''longitude 2''|''radius of the planet in km (optional)''|7=units=''(optional)''}}

or

{{tlx|Great circle distance|<nowiki>lat1=|long1=|lat2=|long2=|r=|units=</nowiki>}}

*<code>''latitude 1''</code>, <code>''longitude 1''</code>, <code>''latitude 2''</code>, and <code>''longitude 2''</code> are the coordinates of your point. They should be specified as [[decimal degrees]], not in [[Degree (angle)#Subdivisions|degree-minute-second (DMS)]] notation, and South and West latitude and longitude should be expressed as negative numbers. You can use {{tl|Decdeg}} to convert from DMS to decimal notation (e.g. {{tlx|Great circle distance|<nowiki>{{decdeg|40|42|45.72}}|{{decdeg|-70|0|21.24}}|{{decdeg|34|2|60}}|{{decdeg|-118|15|0}}|units=mi</nowiki>}} yields {{Great circle distance|{{decdeg|40|42|45.72}}|{{decdeg|-70|0|21.24}}|{{decdeg|34|2|60}}|{{decdeg|-118|15|0}}|units=mi}}).

*The <code>''radius of the planet in km''</code> (<code>r=</code>) parameter defaults to 6373&nbsp;km, which is the radius of the earth at 39 degrees from the equator. Because the earth is an [[ellipsoid]], not a perfect sphere, the further your points are from this latitude the less accurate your answer will be. You can substitute this value for the radius at your midpoint, if known, or use any other value (for example, you could use 3390 if you want distances on [[Mars]]).

*<code>''units''</code> can be any unit recognized by [[:Template:Convert]].

==Template Data==
<templatedata>
{
	"params": {
		"r": {
			"aliases": [
				"5"
			],
			"label": "Radius",
			"description": "Radius of the planet in kilometers",
			"type": "number",
			"default": "6373"
		},
		"lat2": {
			"aliases": [
				"3"
			],
			"label": "Latitude 2",
			"description": "Latitude of point 2 in decimal degrees",
			"type": "number",
			"default": "0",
			"required": true
		},
		"lat1": {
			"aliases": [
				"1"
			],
			"label": "Latitude 1",
			"description": "Latitude of point 1 in decimal degrees",
			"type": "number",
			"default": "0",
			"required": true
		},
		"long2": {
			"aliases": [
				"4"
			],
			"label": "Longitude 2",
			"description": "Longitude of point 2 in decimal degrees",
			"type": "number",
			"default": "0",
			"required": true
		},
		"long1": {
			"aliases": [
				"2"
			],
			"label": "Longitude 1",
			"description": "Longitude of point 1 in decimal degrees",
			"type": "number",
			"default": "0",
			"required": true
		},
		"units": {
			"label": "Units",
			"description": "Units to output distance in (defaults to km). Can be any distance unit supported by [[:Template:Convert]]",
			"type": "string",
			"default": "km"
		}
	},
	"description": "Computes the great circle distance between two points, specified by the latitude and longitude, using the haversine formula.",
	"paramOrder": [
		"lat1",
		"long1",
		"lat2",
		"long2",
		"r",
		"units"
	]
}
</templatedata>


<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Гурӯҳ:Coordinates templates]] [[Гурӯҳ:Coordinates conversion templates]]
}}</includeonly>