List Watch Areas

Use this query to list public watch areas at a given location.

Required Parameters

Area in the form of one area type below.

Optional Parameters

• radius - Radius to search for watch areas by. Radius is in units of degrees. Default is 1.
• watcher_search - Search terms to limit the results by.
• page - Page to display the results as. Results are sorted by distance from the required parameter area's center. Default is 1.
• num_results - Number of results to return. Default is 20

Attributes and Structure

This query returns an array of watch areas. A watch area has the following attributes:

• created_at - Timestamp of when the watch area was created.
• id -
• locale - Locale emails will be delivered in.
• max_lat - Lat/Lng coordinates of a bounding box.
• max_lng - Lat/Lng coordinates of a bounding box.
• min_lat - Lat/Lng coordinates of a bounding box.
• min_lng -Lat/Lng coordinates of a bounding box.
• public_description - Text description of the watch area.
• public_token - Public unique token for the watch area. Used in some search queries.
• search - Search terms to filter results by.
• send_on_comment - Yes/No send email on watch area if a comment was made.
• title - Title of watch area.
• updated_at - Timestamp the watch area was last updated.

Example

http://seeclickfix.com/api/watchers/list.xml?at=new+haven&num_results=30

This query says show me the closest 30 watch areas to “New Haven, CT”.

<watchers type="array">
    <watcher>
        <created-at type="timestamp">Thu Jan 08 16:29:22 UTC 2009</created-at>
        <id type="integer">552</id>
        <locale>en</locale>
        <max-lat type="float">41.3143696793156</max-lat>
        <max-lng type="float">-72.9131698608398</max-lng>
        <min-lat type="float">41.3003787722824</min-lat>
        <min-lng type="float">-72.9354000091553</min-lng>
        <public-description>
            This is the watch area for the 1'st policing district Lt. R. Sweeney
        </public-description>
        <public-token>475c53cfd808c29bc430e3b438ad995fdb4ec6b8</public-token>
        <search>
            prost drug speed cop police illegal shoes stolen gun theft hooker loitering 
        </search>
        <send-on-comment type="boolean">false</send-on-comment>
        <title>
            Downtown Wooster Square Policing District - Lt. Rebecca Sweeney
        </title>
        <updated-at type="timestamp">Thu Aug 20 11:30:46 UTC 2009</updated-at>
    </watcher>