<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>getTravelTime</title><revhistory><revision><revnumber>13</revnumber><date>2014-02-10 18:28:49</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>12</revnumber><date>2013-08-20 14:47:28</date><authorinitials>Romulus</authorinitials></revision><revision><revnumber>11</revnumber><date>2013-08-20 14:47:02</date><authorinitials>Romulus</authorinitials><revremark>Renamed from 'city.getTravelTime'.</revremark></revision><revision><revnumber>10</revnumber><date>2013-08-04 21:37:21</date><authorinitials>tech</authorinitials></revision><revision><revnumber>9</revnumber><date>2013-08-04 21:37:00</date><authorinitials>tech</authorinitials></revision><revision><revnumber>8</revnumber><date>2013-08-04 21:36:05</date><authorinitials>tech</authorinitials></revision><revision><revnumber>7</revnumber><date>2013-08-04 21:33:37</date><authorinitials>tech</authorinitials></revision><revision><revnumber>6</revnumber><date>2013-08-04 21:27:57</date><authorinitials>tech</authorinitials></revision><revision><revnumber>5</revnumber><date>2013-08-04 21:26:57</date><authorinitials>tech</authorinitials></revision><revision><revnumber>4</revnumber><date>2013-08-04 21:26:22</date><authorinitials>tech</authorinitials></revision><revision><revnumber>3</revnumber><date>2013-07-31 05:26:15</date><authorinitials>tech</authorinitials></revision><revision><revnumber>2</revnumber><date>2013-07-31 05:25:48</date><authorinitials>tech</authorinitials></revision><revision><revnumber>1</revnumber><date>2013-07-31 05:23:59</date><authorinitials>tech</authorinitials></revision></revhistory></articleinfo><para>this function will return the time in seconds it takes to march from point A to point B using a particular type of troops, taking into account player's relevant tech levels for compass or horseback riding. </para><section><title>usage:</title><para>city.getTravelTime(fieldId1,fieldId2,troopBean,type) </para><para>fieldId1 and fieldId2 are the <ulink url="http://guide.neatportal.com/wiki/getTravelTime/wiki/FieldId#">fieldId</ulink>'s which represent coordinates for point A and B, troopBean is a special object representing a single wave of troops of any type or combination, and type can be 2 for transport or reinforcement waves or 5 for attack or scout waves. </para></section><section><title>example:</title><screen><![CDATA[coords = "123,456"
targetId = GetFieldId(coords)
// converts coords into fieldId
]]><![CDATA[
troops = "s:100k"
troopBean = GetTroops(troops)
// converts troop string into troopBean object
]]><![CDATA[
transTime = city.getTravelTime(city.fieldId, targetId, troopBean, 2)  // returns time to transport or reinforce target coords in seconds - from point A (city.fieldId) to point B (targetId) using specified troopBean
]]><![CDATA[
attackTime = city.getTravelTime(city.fieldId, targetId, troopBean, 5)  // returns time to send attack or scout to target coords in seconds - from point A (city.fieldId) to point B (targetId) using specified troopBean]]></screen></section><section><title>Related Functions:</title><para><ulink url="http://guide.neatportal.com/wiki/getTravelTime/wiki/GetFieldId#">GetFieldId()</ulink> </para><para><ulink url="http://guide.neatportal.com/wiki/getTravelTime/wiki/GetTroops#">GetTroops()</ulink> </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/getTravelTime/wiki/CategoryFunctions#">CategoryFunctions</ulink> </para></section></article>