grandline

Routes Matrix

Bulk distance grid: every origin × every destination in one call.

A cell is metered like an individual lookup, so a 12×30 matrix consumes 360 calls against the monthly quota — same total cost as 360 single calls, far fewer round-trips. variant omitted returns the recommended (primary) distance per cell; set it to force a specific routing. Cells with no cached pair come back distance_nm: null, availability: "route_not_in_cache".

post/api/v1/routes/matrix

Request

  • Base URL: https://grandline.luzomi.com
  • URL: https://grandline.luzomi.com/api/v1/routes/matrix
  • Auth: none declared

Request body

originsinteger[] required

Origin port_ids.

destinationsinteger[] required

Destination port_ids.

variantstring nullable

One of primary/via_suez/via_panama/via_cape. Omit for the recommended (primary) distance per cell.

Response

Successful Response

variantstring nullable required
cell_countinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.