## Calculate a distance matrix between points

`$client->routing->matrix(GeoJsonGeometry destinations, GeoJsonGeometry origins, ?Mode mode): MatrixResult`

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

Calculate a distance matrix between points

### Parameters

- `destinations: GeoJsonGeometry`

  Destination points (GeoJSON MultiPoint geometry)

- `origins: GeoJsonGeometry`

  Origin points (GeoJSON MultiPoint geometry)

- `mode?:optional Mode`

  Travel mode

### Returns

- `MatrixResult`

  - `list<list<float>> distances`

    Distance matrix (meters), origins x destinations

  - `list<list<float>> durations`

    Duration matrix (seconds), origins x destinations

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'local');

$matrixResult = $client->routing->matrix(
  destinations: ['coordinates' => [0], 'type' => 'Point'],
  origins: ['coordinates' => [0], 'type' => 'Point'],
  mode: 'auto',
);

var_dump($matrixResult);
```

#### Response

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