magnus919_agent-skills/raleigh/references/api-reference.md

# ArcGIS REST API Reference

The Raleigh Open Data portal is built on ArcGIS Hub, exposing datasets through standard ArcGIS REST API endpoints.

## URL Patterns

### Dataset Discovery

Search the Raleigh catalog:

```
GET https://ral.maps.arcgis.com/sharing/rest/search
  ?q=group:7961306fe9cd49e3a0fb8f1cd1180798%20OR%20group:33b8fd49e9e64a3999daf98b697eeddd
  &f=json
  &num=100
  &sortField=title
  &sortOrder=asc
```

- `q`: Search query. Use `group:...` to search within a specific group, or `title:keyword` for title search.
- `f`: Output format (`json`, `html`, `geojson`)
- `num`: Results per page (max 100)
- `start`: Offset for pagination

### Layer Info

Get metadata about a specific layer, including field names, types, and aliases:

```
GET {serviceUrl}/{serviceType}/{layerId}?f=json
```

For FeatureServer (spatial services):
```
GET https://services.arcgis.com/v400IkDOw1ad7Yad/arcgis/rest/services/DogParkLocations_Existing_PUBLIC/FeatureServer/0?f=json
```

For MapServer (mapping services):
```
GET https://maps.wake.gov/arcgis/rest/services/Inspections/RestaurantInspectionsOpenData/MapServer/1?f=json
```

### Query Records

Query features from a layer with optional filters:

```
GET {serviceUrl}/{serviceType}/{layerId}/query
  ?where={whereClause}
  &outFields={fieldList}
  &returnGeometry={true|false}
  &f={format}
  &resultRecordCount={limit}
  &resultOffset={offset}
  &orderByFields={field1,field2}
  &outSR=4326
```

| Parameter | Description | Example |
|-----------|-------------|---------|
| `where` | SQL WHERE clause, URL-encoded | `1%3D1` (all), `SCORE%3C70` (score < 70) |
| `outFields` | Comma-separated field names | `*` (all), `SITE,ADDRESS` (specific) |
| `returnGeometry` | Include spatial data | `true` (default for FeatureServer), `false` |
| `f` | Output format | `geojson`, `json`, `html`, `kmz` |
| `resultRecordCount` | Max records to return | `10`, `100`, `1000` |
| `resultOffset` | Pagination offset | `0`, `100`, `200` |
| `orderByFields` | Sort fields | `SCORE DESC`, `DATE_ ASC` |
| `outSR` | Output spatial reference | `4326` (WGS84 lat/lng) |

### Export Formats

ArcGIS supports multiple export formats from the query endpoint:

| Format | `f=` Parameter | Use Case |
|--------|---------------|----------|
| GeoJSON | `geojson` | Spatial data in standard format |
| JSON | `json` | Tabular/attribute data |
| HTML | `html` | Human-readable table |
| KMZ | `kmz` | Google Earth import |

FeatureServer also supports download via `supportedExportFormats`:
csv, shapefile, sqlite, geoPackage, fileGDB, featureCollection, geojson, kml, excel

## Server Registry

The Raleigh Open Data portal aggregates from these ArcGIS servers:

| Server | Base URL | Content |
|--------|----------|---------|
| Raleigh City | `https://services.arcgis.com/v400IkDOw1ad7Yad/arcgis/rest/services/` | ~61 FeatureServer datasets |
| Raleigh Maps | `https://maps.raleighnc.gov/arcgis/rest/services/` | ~23 MapServer layers |
| Wake County | `https://maps.wake.gov/arcgis/rest/services/` | ~38 MapServer services |
| Wake County (alt) | `https://maps.wakegov.com/arcgis/rest/services/` | Alternative county endpoint |

## Query Examples

### All dog parks with shade
```
GET https://services.arcgis.com/v400IkDOw1ad7Yad/arcgis/rest/services/DogParkLocations_Existing_PUBLIC/FeatureServer/0/query
  ?where=SHADE%3D%27Yes%27
  &outFields=*
  &returnGeometry=true
  &f=geojson
```

### Food inspections with scores under 75
```
GET https://maps.wake.gov/arcgis/rest/services/Inspections/RestaurantInspectionsOpenData/MapServer/1/query
  ?where=SCORE%3C75
  &outFields=*&returnGeometry=false
  &f=json
  &resultRecordCount=20
  &orderByFields=SCORE%20ASC
```

### Recent building permits
```
GET https://services.arcgis.com/v400IkDOw1ad7Yad/arcgis/rest/services/Building_Permits_Issued_Past_180_Days/FeatureServer/0/query
  ?where=1%3D1
  &outFields=*
  &returnGeometry=false
  &f=json
  &resultRecordCount=50
  &orderByFields=ISSUE_DATE%20DESC
```

### Find crashes near a location (not natively supported — use where clause on spatial fields where available)
```
GET https://maps.wake.gov/arcgis/rest/services/CrashesInvolvingCyclists/MapServer/0/query
  ?where=1%3D1
  &outFields=*
  &returnGeometry=true
  &f=geojson
  &resultRecordCount=100
```

## Notes

- All endpoints are public — no API key required
- Rate limits are generous but not documented; use reasonable pagination
- Dates are returned as Unix timestamps in milliseconds (divide by 1000 for seconds)
- `returnGeometry=false` is faster for tabular queries when you don't need spatial data
- MapServer layers with `type: "Table"` have no geometry — always use `returnGeometry=false`
- The `where` parameter supports standard SQL operators: `=`, `<`, `>`, `<=`, `>=`, `<>`, `LIKE`, `IN`, `AND`, `OR`, `NOT`
- String values in WHERE must be single-quoted: `WHERE NAME='Millbrook-Exchange'`