# Tìm kiếm địa điểm

> Tìm kiếm địa điểm trong một tài khoản theo từ khoá, refId hoặc văn phòng.

Source: https://docs.fleetwork.vn/vi/places/places-search

**GET** `https://live.fleetwork.vn/api/v1/workspace/places/search`

Tìm kiếm các địa điểm khớp với một từ khoá.

## Tham số query

| Tham số   | Kiểu   | Bắt buộc | Mô tả                                                     |
| --------- | ------ | -------- | --------------------------------------------------------- |
| `keyword` | string | Tuỳ chọn | Tìm theo tên, địa chỉ hoặc ID tham chiếu (refId).         |

### Ví dụ yêu cầu

```bash
curl -X GET \
  "https://live.fleetwork.vn/api/v1/workspace/places/search?keyword=main" \
  -H "API-KEY: <your-key>"
```

### Ví dụ phản hồi

```json
{
  "code": "OK",
  "message": null,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "refId": "REF1001",
      "name": "Main Warehouse",
      "address": "100 Industrial Road, District 1",
      "lat": 10.7719,
      "lng": 106.698",
      "officeId": "3a50b423-9174-4935-9b2a-6f6dbbf9f78d"
    },
    {
      "id": "f64e3fa8-b645-43fa-832c-c3df678abc12",
      "refId": "CUST01",
      "name": "Customer Alpha",
      "address": "123 Union Street",
      "lat": 10.7731,
      "lng": 106.703
    }
  ]
}
```

Mỗi địa điểm đều có `refId` để sử dụng trong các API khác, ví dụ [Tạo công việc](https://docs.fleetwork.vn/vi/jobs/jobs-create).