AutoGRAPH.NET Service GetTripsArea — различия между версиями

Материал из TK
Перейти к: навигация, поиск
(WCF)
 
(не показано 6 промежуточных версий 2 участников)
Строка 1: Строка 1:
Возвращает рейсы и обработанные поля по запрошенным ТС за период.
+
Возвращает рейсы и обработанные поля по запрошенным ТС за период. Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично.
  +
Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично.
 
  +
== JSON ==
  +
  +
Вызов:
  +
<pre>http://localhost/ServiceJSON/GetTripsArea?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef102&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0
  +
http://localhost/ServiceJSON/GetTripsAreaTotal?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef102&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0
  +
</pre>
  +
  +
Дата и время задаются в формате '''yyyyMMdd''' или '''yyyyMMdd-HHmm'''<br/>Если ID'ов больше одного - идентификаторы указывается через запятую.<br/>(последний 0 в URL - параметр tripSplitterIndex)
   
 
== WCF ==
 
== WCF ==
   
 
Определение:
 
Определение:
  +
<pre>Dictionary<Guid,RTrips> GetTrips(Guid schemaID, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
<pre>
 
Dictionary<Guid,RTrips> GetTrips(string schemaName, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
+
Dictionary<Guid,RTrips> GetTripsAreaTotal(Guid schemaID, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
Dictionary<Guid,RTrips> GetTripsAreaTotal(string schemaName, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
 
 
</pre>
 
</pre>
   
* schemaName – имя схемы
+
*schemaName – имя схемы
* IDs – список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET Service EnumDevices|EnumDevices]] – поле ID в классе RGroupItem)
+
*IDs – список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – поле ID в классе RGroupItem)
* areaIDs - список идентификаторов геозон полей, по которым выполняется расчет (их можно получить с помощью [[AutoGRAPH.NET Service EnumGeoFences|EnumGeoFences]] – поле ID в классе RGroupItem)
+
*areaIDs - список идентификаторов геозон полей, по которым выполняется расчет (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumGeoFences|EnumGeoFences]] – поле ID в классе RGroupItem)
* SD / ED – соответственно начало и конец временного периода. Время местное по часовому поясу сервера.
+
*SD / ED – соответственно начало и конец временного периода. Время в UTC.
* tripSplitterIndex - идентификатор разбиения на рейсы (по умолчанию 0), -1 если не разбивать на рейсы
+
*tripSplitterIndex - идентификатор разбиения на рейсы (по умолчанию 0), -1 если не разбивать на рейсы
* tripParams - если !=null - то возвращаются только указанные рейсовые параметры. По умолчанию (если tripParams==null) - то все параметры.
+
*tripParams - если&nbsp;!=null - то возвращаются только указанные рейсовые параметры. По умолчанию (если tripParams==null) - то все параметры.
* tripTotalParams - если !=null - то возвращаются только указанные итоговые параметры. По умолчанию (если tripTotalParams==null) - то все параметры.
+
*tripTotalParams - если&nbsp;!=null - то возвращаются только указанные итоговые параметры. По умолчанию (если tripTotalParams==null) - то все параметры.
   
Результат аналогичен [[AutoGRAPH.NET Service GetTrips|GetTrips]] – в дополнение ко всем полям в GetTrips после вызова этих методов заполняется также поле Areas в классе RTrip:
+
Результат аналогичен [[AutoGRAPH.NET_Service_GetTrips|GetTrips]] – в дополнение ко всем полям в GetTrips после вызова этих методов заполняется также поле Areas в классе RTrip:
  +
<pre>public class RTripArea
<pre>
 
public class RTripArea
 
 
{
 
{
 
public Color Color { get; set; } // цвет полигона
 
public Color Color { get; set; } // цвет полигона
Строка 26: Строка 32:
 
}
 
}
 
</pre>
 
</pre>
 
== JSON ==
 
 
Вызов:
 
<pre>
 
http://localhost:8300/GetTripsArea/Demo/25f86189-adc9-445d-940c-abf860874622/618925f8-adc9-445d-940c-a22860874622/20150413-0000/20150413-2359/0
 
http://localhost:8300/GetTripsArea?schemaID=Demo&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0
 
http://localhost:8300/GetTripsAreaTotal/Demo/25f86189-adc9-445d-940c-abf860874622/618925f8-adc9-445d-940c-a22860874622/20150413-0000/20150413-2359/0
 
http://localhost:8300/GetTripsAreaTotal?schemaID=Demo&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0
 
</pre>
 
 
Дата и время задаются в формате '''yyyyMMdd''' или '''yyyyMMdd-HHmm'''<br/>Если ID'ов больше одного - идентификаторы указывается через запятую.<br/>(последний 0 в URL - параметр tripSplitterIndex)
 

Текущая версия на 14:21, 15 октября 2020

Возвращает рейсы и обработанные поля по запрошенным ТС за период. Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично.

JSON

Вызов:

http://localhost/ServiceJSON/GetTripsArea?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef102&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0
http://localhost/ServiceJSON/GetTripsAreaTotal?session=B05043B71F4B9C67C910163779FFF06EDBBAEF994B2D6C3A84DD96EB767A0F44&schemaID=b4b68be6-a124-4ca3-ab02-589e7c2ef102&IDs=25f86189-adc9-445d-940c-abf860874622&areaIDs=618925f8-adc9-445d-940c-a22860874622&SD=20150413-0000&ED=20150413-2359&tripSplitterIndex=0

Дата и время задаются в формате yyyyMMdd или yyyyMMdd-HHmm
Если ID'ов больше одного - идентификаторы указывается через запятую.
(последний 0 в URL - параметр tripSplitterIndex)

WCF

Определение:

Dictionary<Guid,RTrips> GetTrips(Guid schemaID, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
Dictionary<Guid,RTrips> GetTripsAreaTotal(Guid schemaID, Guid[] IDs, Guid[] areaIDs, DateTime SD, DateTime ED, int tripSplitterIndex, string[] tripParams, string[] tripTotalParams)
  • schemaName – имя схемы
  • IDs – список идентификаторов ТС (их можно получить с помощью EnumDevices – поле ID в классе RGroupItem)
  • areaIDs - список идентификаторов геозон полей, по которым выполняется расчет (их можно получить с помощью EnumGeoFences – поле ID в классе RGroupItem)
  • SD / ED – соответственно начало и конец временного периода. Время в UTC.
  • tripSplitterIndex - идентификатор разбиения на рейсы (по умолчанию 0), -1 если не разбивать на рейсы
  • tripParams - если !=null - то возвращаются только указанные рейсовые параметры. По умолчанию (если tripParams==null) - то все параметры.
  • tripTotalParams - если !=null - то возвращаются только указанные итоговые параметры. По умолчанию (если tripTotalParams==null) - то все параметры.

Результат аналогичен GetTrips – в дополнение ко всем полям в GetTrips после вызова этих методов заполняется также поле Areas в классе RTrip:

public class RTripArea
{
    public Color Color { get; set; }            // цвет полигона
    public double[][][] Polygons { get; set; }  // массив полигонов, состоящий из массива точек, каждая из которых возвращается как массив из двухх элементов - широта и долгота
}