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

Материал из TK
Перейти к: навигация, поиск
(Новая страница: «Возвращает рейсы и обработанные поля по запрошенным ТС за период. Единственное отличие G…»)
 
 
(не показано 7 промежуточных версий 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)
 +
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)
  
 
</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 - если&nbsp;!=null - то возвращаются только указанные рейсовые параметры. По умолчанию (если tripParams==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; } // цвет полигона
Строка 24: Строка 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; }  // массив полигонов, состоящий из массива точек, каждая из которых возвращается как массив из двухх элементов - широта и долгота
}
Источник — «http://oldwiki.tk-chel.ru/index.php?title=AutoGRAPH.NET_Service_GetTripsArea&oldid=56853»