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

Материал из TK
Перейти к: навигация, поиск
Строка 1: Строка 1:
Возвращает рейсы и обработанные поля по запрошенным ТС за период.
+
Возвращает рейсы и обработанные поля по запрошенным ТС за период. Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично.
Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично.
 
   
== WCF ==
+
== JSON ==
  +
  +
Вызов:
  +
<pre>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?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)
  +
  +
== WCF&nbsp;''<small><span style="background-color:#FFFF00;">протокол устарел и не рекомендуется к использованию. Будет удалён с 01.06.2020</span></small>'' ==
   
 
Определение:
 
Определение:
  +
<pre>Dictionary<Guid,RTrips> GetTrips(string schemaName, 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(string schemaName, 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 – соответственно начало и конец временного периода. Время местное по часовому поясу сервера.
* 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?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?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)
 

Версия 16:13, 21 января 2020

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

JSON

Вызов:

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?schemaID=Demo&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 протокол устарел и не рекомендуется к использованию. Будет удалён с 01.06.2020

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

Dictionary<Guid,RTrips> GetTrips(string schemaName, 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)
  • schemaName – имя схемы
  • IDs – список идентификаторов ТС (их можно получить с помощью EnumDevices – поле ID в классе RGroupItem)
  • areaIDs - список идентификаторов геозон полей, по которым выполняется расчет (их можно получить с помощью EnumGeoFences – поле ID в классе RGroupItem)
  • SD / ED – соответственно начало и конец временного периода. Время местное по часовому поясу сервера.
  • 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; }  // массив полигонов, состоящий из массива точек, каждая из которых возвращается как массив из двухх элементов - широта и долгота
}