> ## Documentation Index
> Fetch the complete documentation index at: https://maps.solvice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /cube/sync

> Request a cube synchronously. Returns the cube response directly instead of creating an asynchronous job.



## OpenAPI

````yaml POST /cube/sync
openapi: 3.1.0
info:
  title: Solvice Maps Routing API
  description: >
    The Solvice Maps Routing API provides distance matrices, routes, and travel
    time calculations

    for logistics and route optimization applications. Supports multiple routing
    engines including

    OpenStreetMap and TomTom with time-dependent traffic data.
  version: 1.0.0
  contact:
    name: Solvice Support
    url: https://solvice.io
    email: support@solvice.io
servers:
  - url: https://routing.solvice.io
    description: Production server
security:
  - apikey: []
tags:
  - name: Tables
    description: Distance/duration matrix operations
  - name: Cubes
    description: Time-dependent 3D travel time matrices
  - name: Routes
    description: Point-to-point routing
  - name: Trips
    description: Traveling salesman / round-trip optimization
paths:
  /cube/sync:
    post:
      tags:
        - Cubes
      summary: Create cube (sync)
      description: >-
        Request a cube synchronously. Returns the cube response directly instead
        of creating an asynchronous job.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCubeDto'
        required: true
      responses:
        '200':
          description: Get cube response directly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CubeResponseDto'
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Bad gateway - External service error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: Gateway timeout - Request timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    CreateCubeDto:
      description: Cube Dto
      examples:
        - coordinates:
            - - 4.9
              - 50.2
            - - 4.8
              - 50.4
            - - 5
              - 50.9
            - - 5.05
              - 50.9
          sources:
            - 0
            - 1
            - 2
            - 3
          destinations:
            - 0
            - 1
            - 2
            - 3
      type: object
      required:
        - coordinates
      properties:
        coordinates:
          type:
            - array
            - 'null'
          items:
            type: array
            items:
              type: number
              format: double
          description: >-
            The coordinates this request will use, coordinates as [{lon},{lat}]
            values, in decimal degrees.
          minItems: 2
        sources:
          type:
            - array
            - 'null'
          items:
            type: integer
            format: int32
          description: >-
            An array of index elements (0 <= integer < #coordinates) to use
            location with given index as source. Default is to use all.
        destinations:
          type:
            - array
            - 'null'
          items:
            type: integer
            format: int32
          description: >-
            An array of index elements (0 <= integer < #coordinates) to use
            location with given index as destination. Default is to use all.
        vehicleType:
          description: The vehicle type for which the table is requested
          type:
            - string
            - 'null'
          anyOf:
            - $ref: '#/components/schemas/VehicleType'
            - type: 'null'
        date:
          description: >-
            The date for which you want to calculate the cube. This will take
            into account predictive travel time based on TomTom data. Format
            YYYY-MM-DD. Default is current date.
          type:
            - string
            - 'null'
          anyOf:
            - $ref: '#/components/schemas/LocalDate'
            - type: 'null'
        responseType:
          type:
            - string
            - 'null'
          description: >-
            Specifies the type of response to return. Currently only 'matrix' is
            supported (returns travel time matrices for each time slice).
    CubeResponseDto:
      description: Cube Response
      examples:
        - destinations:
            - hint: >-
                eX5AgduYjYYsAAAAlAAAAHIAAAAAAAAAxBf6QX7HzELIz51CAAAAACwAAACUAAAAcgAAAAAAAAAVtwAAlMNKAIj__QKgxEoAwP39AgEAXwRPrDVe
              distance: 54.20808645369059
              name: Avenue de la Restauration
              location:
                - 4.899732
                - 50.200456
            - hint: >-
                o_v2gPMxk4KXAAAAQwAAAJsAAADWAwAA4YOXQ0HtBEOh05pDGnn1RJcAAABDAAAAmwAAANYDAAAVtwAAEyhJAG0BAQMAPkkAAAsBAwMAXxRPrDVe
              distance: 483.4921257061384
              name: Route des Trois Communes
              location:
                - 4.794387
                - 50.397549
            - hint: >-
                WvwMgrAseoRNAAAAAAAAALwAAAAAAAAAvYZVQgAAAAAK0AFDAAAAAE0AAAAAAAAAvAAAAAAAAAAVtwAAI1ZMAPmtCANAS0wAIKwIAwYAXw9PrDVe
              distance: 202.89814553989248
              name: Wittebos
              location:
                - 5.002787
                - 50.900473
            - hint: >-
                GtVBggTgEIkDAAAADwAAAMUAAAAAAAAAbWKjQHMstUHaEZlDAAAAAAMAAAAPAAAAxQAAAAAAAAAVtwAA-Q5NAN2rCAOQDk0AIKwIAwsAHw5PrDVe
              distance: 10.496399718824598
              name: Tiensestraat
              location:
                - 5.050105
                - 50.899933
          coordinates:
            - - 0
              - 1976.1
              - 5772.3
              - 5642.6
            - - 2010.2
              - 0
              - 4783.9
              - 4654.2
            - - 5817.2
              - 4797.4
              - 0
              - 508.6
            - - 5705.3
              - 4685.5
              - 530.2
              - 0
          sources:
            - hint: >-
                eX5AgduYjYYsAAAAlAAAAHIAAAAAAAAAxBf6QX7HzELIz51CAAAAACwAAACUAAAAcgAAAAAAAAAVtwAAlMNKAIj__QKgxEoAwP39AgEAXwRPrDVe
              distance: 54.20808645369059
              name: Avenue de la Restauration
              location:
                - 4.899732
                - 50.200456
            - hint: >-
                o_v2gPMxk4KXAAAAQwAAAJsAAADWAwAA4YOXQ0HtBEOh05pDGnn1RJcAAABDAAAAmwAAANYDAAAVtwAAEyhJAG0BAQMAPkkAAAsBAwMAXxRPrDVe
              distance: 483.4921257061384
              name: Route des Trois Communes
              location:
                - 4.794387
                - 50.397549
            - hint: >-
                WvwMgrAseoRNAAAAAAAAALwAAAAAAAAAvYZVQgAAAAAK0AFDAAAAAE0AAAAAAAAAvAAAAAAAAAAVtwAAI1ZMAPmtCANAS0wAIKwIAwYAXw9PrDVe
              distance: 202.89814553989248
              name: Wittebos
              location:
                - 5.002787
                - 50.900473
            - hint: >-
                GtVBggTgEIkDAAAADwAAAMUAAAAAAAAAbWKjQHMstUHaEZlDAAAAAAMAAAAPAAAAxQAAAAAAAAAVtwAA-Q5NAN2rCAOQDk0AIKwIAwsAHw5PrDVe
              distance: 10.496399718824598
              name: Tiensestraat
              location:
                - 5.050105
                - 50.899933
      type: object
      properties:
        tableId:
          type: integer
          format: int64
          description: Table response id. Not to be confused with table request id.
        durations:
          type:
            - array
            - 'null'
          items:
            type: array
            items:
              type: number
              format: double
          description: >-
            Time distance matrix. In order of sources to destinations indexes in
            request.
        distances:
          type:
            - array
            - 'null'
          items:
            type: array
            items:
              type: number
              format: double
          description: >-
            Distance matrix. In order of sources to destinations indexes in
            request.
        sources:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/Waypoint'
          description: Actual sources snapped to map.
        destinations:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/Waypoint'
          description: Actual destinations snapped to map.
        durationSlices:
          type:
            - array
            - 'null'
          items:
            type: array
            items:
              type: array
              items:
                type: number
                format: double
          description: >-
            Time distance matrix. In order of sources to destinations indexes in
            request.
        coefficients:
          type:
            - array
            - 'null'
          items:
            type: array
            items:
              type: array
              items:
                type: number
                format: double
          description: >-
            Travel Time cube. In order of sources to destinations indexes in
            request. Inner array is list of 6 coefficients.
        slices:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/SliceDto'
          description: >-
            Time slice information indicating which time periods each slice
            represents.
    ErrorResponse:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
        timestamp:
          type: integer
          format: int64
    VehicleType:
      type: string
      enum:
        - CAR
        - BIKE
        - TRUCK
        - ELECTRIC_CAR
        - ELECTRIC_BIKE
    LocalDate:
      type: string
      format: date
      examples:
        - '2022-03-10T00:00:00.000Z'
    Waypoint:
      type: object
      properties:
        hint:
          type:
            - string
            - 'null'
          description: >-
            Unique internal identifier of the segment (ephemeral, not constant
            over data updates) This can be used on subsequent request to
            significantly speed up the query and to connect multiple services.
        distance:
          type:
            - number
            - 'null'
          format: double
          description: The distance of the snapped point from the original
        name:
          type:
            - string
            - 'null'
          description: Name of the street the coordinate snapped to
        location:
          type:
            - array
            - 'null'
          items:
            type: number
            format: double
          description: >-
            Array that contains the [longitude, latitude] pair of the snapped
            coordinate
    SliceDto:
      type: object
      description: Time slice information
      properties:
        sliceNumber:
          type:
            - integer
            - 'null'
          format: int32
          description: Slice number identifier
        startHour:
          type:
            - number
            - 'null'
          format: double
          description: Start hour of the time slice (24-hour format)
        endHour:
          type:
            - number
            - 'null'
          format: double
          description: End hour of the time slice (24-hour format)
  securitySchemes:
    apikey:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Include your API key in the Authorization
        header.

````