# NearestLocationsResponse

Model ID: `NearestLocationsResponse`

Response for GET /locations/nearest.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `location` | `string|null` | Yes |  |  |  | Yes | The free-text location searched, when `location` was supplied instead of lat/lon. |
| `locations` | array of [`NearestLocation`](./NearestLocation.md) | Yes |  |  |  | No | Matching nearby locations. |
| `note` | `string|null` | No |  |  |  | Yes | Explanatory note, present only for the hardcoded fallback source. |
| `radius_km` | `number` | Yes |  |  |  | No | Search radius in kilometers that was applied. |
| `source` | `string` | Yes |  | google_places, google_places_v1, hardcoded |  | No | Data source for this response: `google_places` (legacy) or `google_places_v1` (new Places API v1) when an API key is configured; otherwise a `hardcoded` fallback. |
| `total` | `integer` | Yes |  |  |  | No | Number of locations in this response. |

## Example

None declared in canonical OpenAPI.