## Calculate a distance matrix between points

`$ plaza routing matrix`

**post** `/api/v1/matrix`

Calculate a distance matrix between points

### Parameters

- `--destinations: object { coordinates, type }`

  Destination points (GeoJSON MultiPoint geometry)

- `--origins: object { coordinates, type }`

  Origin points (GeoJSON MultiPoint geometry)

- `--mode: optional "auto" or "foot" or "bicycle"`

  Travel mode

### Returns

- `matrix_result: object { distances, durations }`

  - `distances: array of array of number`

    Distance matrix (meters), origins x destinations

  - `durations: array of array of number`

    Duration matrix (seconds), origins x destinations

### Example

```cli
plaza routing matrix \
  --api-key 'My API Key' \
  --destinations '{coordinates: [0], type: Point}' \
  --origins '{coordinates: [0], type: Point}'
```

#### Response

```json
{
  "distances": [
    [
      0
    ]
  ],
  "durations": [
    [
      0
    ]
  ]
}
```