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

# Snap a single coordinate to the nearest routable segments



## OpenAPI

````yaml /openapi/osrm.json get /nearest/v1/{profile}/{coordinates}
openapi: 3.1.0
info:
  title: JustRouting OSRM API
  version: v1
  description: >-
    OSRM-compatible routing services hosted by JustRouting: route, table, match,
    trip, and nearest. All requests require a Bearer API key. Coordinates use
    `lng,lat` order and must be within a single country (Southeast Asia).
  contact:
    email: hello@justrouting.tech
    name: JustRouting
    url: https://justrouting.tech
servers:
  - url: https://api.justrouting.tech
    description: Production
security:
  - bearerAuth: []
tags:
  - name: route
    description: Directions between coordinates
  - name: table
    description: N×N travel time/distance matrix
  - name: match
    description: Map matching for GPS traces
  - name: trip
    description: Traveling salesman optimization
  - name: nearest
    description: Snap a coordinate to the road network
paths:
  /nearest/v1/{profile}/{coordinates}:
    get:
      tags:
        - nearest
      summary: Snap a single coordinate to the nearest routable segments
      operationId: getNearest
      parameters:
        - name: profile
          in: path
          required: true
          schema:
            type: string
            enum:
              - driving
              - motorcycle
        - name: coordinates
          in: path
          required: true
          schema:
            type: string
          description: A single `{lng},{lat}` pair.
        - name: number
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Number of nearest segments to return.
        - $ref: '#/components/parameters/Bearings'
      responses:
        '200':
          description: Snapped segments
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NearestResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OsrmError'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitError'
components:
  parameters:
    Bearings:
      name: bearings
      in: query
      schema:
        type: string
      description: '`{bearing},{range};...` per coordinate, e.g. `0,20` = north ±20°.'
  schemas:
    NearestResponse:
      type: object
      properties:
        code:
          type: string
          enum:
            - Ok
        waypoints:
          type: array
          items:
            $ref: '#/components/schemas/Waypoint'
    OsrmError:
      type: object
      properties:
        code:
          type: string
          enum:
            - InvalidUrl
            - InvalidService
            - InvalidVersion
            - InvalidOptions
            - InvalidQuery
            - InvalidValue
            - NoSegment
            - NoRoute
            - NoTable
            - NoMatch
            - NoTrips
            - TooBig
            - DisabledDataset
        message:
          type: string
    AuthError:
      type: object
      properties:
        code:
          type: string
          enum:
            - missing_auth
            - invalid_api_key
        message:
          type: string
    RateLimitError:
      type: object
      properties:
        code:
          type: string
          enum:
            - rate_limited
        message:
          type: string
    Waypoint:
      type: object
      properties:
        name:
          type: string
          description: Street name the coordinate snapped to.
        location:
          type: array
          items:
            type: number
          minItems: 2
          maxItems: 2
          description: Snapped position as `[lng, lat]`.
        distance:
          type: number
          description: Snapping offset in meters.
        hint:
          type: string
          description: Opaque segment identifier, reusable as the `hints` parameter.
        nodes:
          type: array
          items:
            type: integer
          description: OSM node ids of the segment.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key created in the JustRouting dashboard.

````