# HERE Matrix Calculation API

**Canonical:** https://apis.io/apis/here/here-matrix-calculation-api/  
**Provider:** HERE — https://apis.io/providers/here/  
**Base URL:** https://account.api.here.com  
**Documentation:** https://docs.here.com/identity-and-access-management/reference

HERE Matrix Calculation API is one of 139 APIs that [HERE](https://apis.io/providers/here/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Matrix Calculation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Calculation of routing matrices in one of the following modes: * Flexible * Region * Profile The values of the `regionDefinition` and `profile` parameters determine which mode is used. The following table describes the capabilities and limitations of each mode. | Mode | regionDefinition parameter | profile parameter provided? | Custom Options & Time Awareness<br>(incl. live traffic) | Unlimited region | Matrix size limit<br>(synchronous) | Matrix size limit<br>(asynchronous) | |----------|------------------------------|-------------------------------|---------------------------------------------------------|-------------------------------------------------------------------------------|------------------------------------|-------------------------------------| | Flexible | `world` | no | yes | yes | 15 x 100 or 100 x 1 | 15 x 100 or 100 x 1 | | Region | one of:<ul><li>`circle`<li>`boundingBox`<li>`polygon`<li>`autoCircle`| no | yes | no<br>origins and destinations must be within a region of max 400 km diameter | 500 x 500 | 10,000 x 10,000 | | Profile | `world` | yes | no | yes | 500 x 500 or 1 x 2000 or 2000 x 1 | 10,000 x 10,000 | Note that the combination of specifying a `profile` along with a `regionDefinition` not equal to `world` is not allowed. ## Synchronous vs. Asynchronous Requests Matrix requests can be synchronous or asynchronous. Use the `async` query parameter to indicate the request type. All 3 modes are compatible with both synchronous and asynchronous requests. Synchronous requests impose additional limitations on maximum matrix sizes (see table above).

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| POST | `/matrix` | Submit matrix for calculation |
| GET | `/matrix/{matrixId}/status` | Status of submitted matrix calculation |
| GET | `/matrix/{matrixId}` | Result of successfully completed calculation |

## Machine-readable artifacts (37)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-matrix-calculation-api-openapi.yml
- **Documentation** — https://docs.here.com/identity-and-access-management/docs
- **APIReference** — https://docs.here.com/identity-and-access-management/reference
- **Documentation** — https://docs.here.com/data-api/docs
- **APIReference** — https://docs.here.com/data-api/reference
- **Documentation** — https://docs.here.com/usage/docs
- **APIReference** — https://docs.here.com/usage/reference
- **Documentation** — https://docs.here.com/destination-weather/docs
- **APIReference** — https://docs.here.com/destination-weather/reference
- **Documentation** — https://docs.here.com/ev-products/docs
- **APIReference** — https://docs.here.com/ev-products/reference
- **Documentation** — https://docs.here.com/fuel-prices/docs
- **APIReference** — https://docs.here.com/fuel-prices/reference
- **Documentation** — https://docs.here.com/geocoding-and-search/docs
- **APIReference** — https://docs.here.com/geocoding-and-search/reference
- **Documentation** — https://docs.here.com/routing/docs
- **APIReference** — https://docs.here.com/routing/reference
- **Documentation** — https://docs.here.com/positioning/docs
- **APIReference** — https://docs.here.com/positioning/reference
- **Documentation** — https://docs.here.com/indoor-map/docs
- **APIReference** — https://docs.here.com/indoor-map/reference
- **Documentation** — https://docs.here.com/transit/docs
- **APIReference** — https://docs.here.com/transit/reference
- **Documentation** — https://docs.here.com/map-attributes/docs
- **APIReference** — https://docs.here.com/map-attributes/reference
- **Documentation** — https://docs.here.com/map-rendering/docs
- **APIReference** — https://docs.here.com/map-rendering/reference
- **Documentation** — https://docs.here.com/workspace/docs
- **APIReference** — https://docs.here.com/workspace/reference
- **Documentation** — https://docs.here.com/tour-planning/docs
- **APIReference** — https://docs.here.com/tour-planning/reference
- **Documentation** — https://docs.here.com/tracking/docs
- **APIReference** — https://docs.here.com/tracking/reference
- **Documentation** — https://docs.here.com/traffic-api/docs
- **APIReference** — https://docs.here.com/traffic-api/reference
- **Documentation** — https://docs.here.com/wego-pro/docs
- **APIReference** — https://docs.here.com/wego-pro/reference

## Other HERE APIs (12)

- [HERE Geocoding and Search API](https://apis.io/apis/here/geocoding-search/)
- [HERE Autosuggest API](https://apis.io/apis/here/autosuggest/)
- [HERE Tour Planning API](https://apis.io/apis/here/tour-planning/)
- [HERE Public Transit API](https://apis.io/apis/here/public-transit/)
- [HERE Destination Weather API](https://apis.io/apis/here/destination-weather/)
- [HERE Map Tile API](https://apis.io/apis/here/map-tile/)
- [HERE Map Image API](https://apis.io/apis/here/map-image/)
- [HERE Tracking API](https://apis.io/apis/here/tracking/)
- [HERE Positioning API](https://apis.io/apis/here/positioning/)
- [HERE Parking API](https://apis.io/apis/here/parking/)
- [HERE Platform Data API](https://apis.io/apis/here/platform-data/)
- [HERE HD Live Map](https://apis.io/apis/here/hd-live-map/)

## Tags

Matrix Calculation

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/here/here-matrix-calculation-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/here/.