GetCamerasOnRoute Method
GetCamerasOnRoute returns all cameras within 100 meters of the route specified by the given latitude/longitude values, in the order in which they appear along the route.
In this example, only the cameras within 100 meters of the blue route will be returned
Syntax
GetCamerasOnRoute2(string strCoordinates, string strRoadNames, int intOptions, string strPassword)
Parameters
| Name | Type | Description |
|---|---|---|
| strCoordinates | str |
A list of comma-separated latitude/longitude coordinates (representing route segments) in parentheses delimited by commas.
Each coordinate must be unique within the list.
The minimum number of required coordinates is 2, and the maximum is 1,000.
Note: While the method allows up to 1,000 coordinates, the maximum number that can be listed in a URL query string in a browser is limited. |
| strRoadNames | string |
A list of up to 1,000 road names delimited by the or symbol ( ‘|’ ).
This parameter is required, but may be left blank.
If one or more road names are supplied, only cameras with names containing one of the supplied road names are returned.
If no road names are supplied, all cameras are returned.
The method treats certain variations on road names as equivalent,
e.g. “Street”, “St”, “St.” are all equivalents, “Highway”, “Hwy”, “Hwy.” are all equivalents, and "I-5", "I5" are equivalents.
Note: While the method allows up to 1,000 road names, the maximum number that can be listed in a URL query string in a browser is limited. |
| intOptions | int |
A set of bitwise flags OR’ed together:
If intOptions is set to 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 2, cameras which have the DetectedOutOfService field set to False are guaranteed to be in service for the next 10 minutes. To establish the guarantee, an image is retrieved for every camera inside the bounding box and cached. This can significantly increase the execution time for this method. 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 GetCamerasOnRoute. 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. If intOptions is OR'ed with the value 32, only cameras which have the DetectedOutOfService field set to False will be returned. Otherwise out-of-service cameras will be included. If intOptions is OR'ed with the value 64, only cameras which have the Visibility field set to Low 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/GetCamerasOnRoute2?strCoordinates=(47.73410,-122.34502),(47.73413,-122.32574),(47.72951,-122.32442),(47.71844,-122.32434),(47.70865,-122.33146),(47.70869,-122.33399)&strRoadNames=&intOptions=0&strPassword=<password> |
| Response |
|---|
| For format, see GetCamerasInBox. |