AutoGRAPH.NET Service GetTripsArea — различия между версиями
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
− | Возвращает рейсы и обработанные поля по запрошенным ТС за период. |
+ | Возвращает рейсы и обработанные поля по запрошенным ТС за период. Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично. |
− | Единственное отличие GetTripsAreaTotal - она возвращает только итоговые данные, поле Items класса RTripStage в результате выполнения GetTripsAreaTotal будет всегда null. Все остальные поля заполняются идентично. |
||
− | == |
+ | == 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 ''<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 – имя схемы |
− | * |
+ | *IDs – список идентификаторов ТС (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumDevices|EnumDevices]] – поле ID в классе RGroupItem) |
− | * |
+ | *areaIDs - список идентификаторов геозон полей, по которым выполняется расчет (их можно получить с помощью [[AutoGRAPH.NET_Service_EnumGeoFences|EnumGeoFences]] – поле ID в классе RGroupItem) |
− | * |
+ | *SD / ED – соответственно начало и конец временного периода. Время местное по часовому поясу сервера. |
− | * |
+ | *tripSplitterIndex - идентификатор разбиения на рейсы (по умолчанию 0), -1 если не разбивать на рейсы |
− | * |
+ | *tripParams - если !=null - то возвращаются только указанные рейсовые параметры. По умолчанию (если tripParams==null) - то все параметры. |
− | * |
+ | *tripTotalParams - если !=null - то возвращаются только указанные итоговые параметры. По умолчанию (если tripTotalParams==null) - то все параметры. |
− | Результат аналогичен [[AutoGRAPH. |
+ | Результат аналогичен [[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; } // массив полигонов, состоящий из массива точек, каждая из которых возвращается как массив из двухх элементов - широта и долгота }