GetHistoricalCamerasInBox Method
GetHistoricalCamerasInBox returns all cameras for a given latitude/longitude bounding box that have an image available at or near the given date/time.
Syntax
GetHistoricalCamerasInBox(double dblMinLongitude, double dblMaxLongitude, double dblMinLatitude, double dblMaxLatitude, int intYear, int intMonth, int intDay, int intHour, int intMinute, int intSeekDirection, int intDesiredWidth, int intDesiredHeight, int intDesiredDepth, int intOptions, string strPassword)
Parameters
| Name | Type | Description |
|---|---|---|
| dblMinLongitude | double | Left edge of the bounding box. |
| dblMaxLongitude | double | Right edge of the bounding box. |
| dblMinLatitude | double | Bottom edge of the bounding box. |
| dblMaxLatitude | double | Top edge of the bounding box. |
| intYear | int | The year, in Coordinated Universal Time (UTC). |
| intMonth | int | The month (a value from 1 to 12), in UTC. |
| intDay | int | The day of the month (a value from 1 to 31, depending on the month), in UTC. |
| intHour | int | The hour (a value from 0 to 23), in UTC. |
| intMinute | int | The minutes (a value from 0 to 59), in UTC. |
| intSeekDirection | int |
The search direction for the historical imagery (a value of -1, 0, or 1):
A search direction of -1 will return the nearest available image, either at or up to 180 minutes before the specified time and date. A search direction of 0 will return the nearest available image, either before, at, or after the specified time and date, within 180 minutes in either direction. A search direction of 1 will return the nearest available image, either at or up to 180 minutes after the specified time and date. |
| intOptions | int |
A set of bitwise flags OR’ed together:
If intOptions is OR’ed with the value 1, only cameras which have streaming video URLs will be returned. Otherwise cameras which provide still images only and cameras which provide both still images and streaming video URLs are returned. If intOptions is OR'ed with the value 4, cameras from pending new regions are included. These pending cameras are for demonstration purposes only and this option must not be used in production systems. If intOptions is OR'ed with the value 8, a “TemporaryPassword” field will be returned for each camera. The temporary passwords will be good for 1 hour after the time of the call to GetHistoricalCamerasInBox. Unlike the main password, temporary passwords may be exposed to the end user. If intOptions is OR'ed with the value 16, only cameras which are hotspot cameras will be returned (see Hotspot Cameras for more information). Otherwise both fixed cameras and hotspot cameras will be returned. |
| strPassword | string | Unique id/password supplied to you previously. |
Return Value
Type: XML
For fields for each returned camera, see GetCamerasInBox.
Example
| Request |
|---|
|
http://www.vizzion.com/TrafficCamsService/TrafficCams.asmx/GetHistoricalCamerasInBox?dblMinLongitude=-77.187&dblMaxLongitude=-76.901&dblMinLatitude=38.799& dblMaxLatitude=38.823&intYear=2020&intMonth=10&intDay=5&intHour=17&intMinute=45& intSeekDirection=0&intOptions=0&strPassword=<password> |
| Response |
|---|
| For format, see GetCamerasInBox. |
Remarks
Not all cameras support historical imagery — contact your Vizzion Account Manager for a list of available regions.