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

# Find Nearest Locations

> Returns all the nearest Point of Interest (POI) locations to a search point. The number returned is restricted to the maximum specified. The locations returned are ordered based on distance from the specified search point.<br/><br/>The search point can be specified as either latitude and longitude or an address (at least one of roadNumber, road, city, postcode or country).



## OpenAPI

````yaml /api-reference/vehicle-tracking.json get /public/v1/customer/{customerId}/location/nearest
openapi: 3.0.1
info:
  title: Vehicle Tracking
  description: >-
    A foundational pack delivering essential “track & trace” capability across
    your fleet.
  contact:
    name: Masternaut
    url: https://www.masternaut.com
    email: support@masternautconnect.com
  version: 124.0.2607160821
servers:
  - url: https://api.masternautconnect.com/connect-webservices/services
    description: Product Server
security:
  - basicAuth: []
tags:
  - name: /alert
    description: Alert history and notification management operations
  - name: /input
    description: Input usage operations for vehicles and drivers
  - name: /journey/detail
    description: Journey detail operations with vehicle and driver perspectives
  - name: /location
    description: Location management operations
  - name: /tokenInformation
    description: Token operations
  - name: /tracking/history
    description: Tracking history operations for vehicles and drivers
  - name: /tracking/journey
    description: Journey tracking and management operations
  - name: /tracking/live
    description: Live tracking operations
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/location/nearest:
    get:
      tags:
        - /location
      summary: Find Nearest Locations
      description: >-
        Returns all the nearest Point of Interest (POI) locations to a search
        point. The number returned is restricted to the maximum specified. The
        locations returned are ordered based on distance from the specified
        search point.<br/><br/>The search point can be specified as either
        latitude and longitude or an address (at least one of roadNumber, road,
        city, postcode or country).
      operationId: findNearestPlaces
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: longitude
          in: query
          description: >-
            The longitude value for the point. Must be specified if latitude has
            been specified.
          required: false
          schema:
            type: number
            description: >-
              The longitude value for the point. Must be specified if latitude
              has been specified.
            format: double
        - name: latitude
          in: query
          description: >-
            The latitude value for the point. Must be specified if longitude has
            been specified.
          required: false
          schema:
            type: number
            description: >-
              The latitude value for the point. Must be specified if longitude
              has been specified.
            format: double
        - name: radius
          in: query
          description: >-
            The radius (in km) of the search area. Must be greater than or equal
            to 1.0 and cannot be more than 500.
          required: true
          schema:
            type: number
            description: >-
              The radius (in km) of the search area. Must be greater than or
              equal to 1.0 and cannot be more than 500.
            format: double
        - name: maximumResultsToReturn
          in: query
          description: Maximum number of locations to return. Must be greater than 0.
          required: true
          schema:
            type: integer
            description: Maximum number of locations to return. Must be greater than 0.
            format: int32
        - name: road
          in: query
          description: Name of a road.
          required: false
          schema:
            type: string
            description: Name of a road.
        - name: roadNumber
          in: query
          description: Road number.
          required: false
          schema:
            type: string
            description: Road number.
        - name: city
          in: query
          description: City
          required: false
          schema:
            type: string
            description: City
        - name: country
          in: query
          description: Country.
          required: false
          schema:
            type: string
            description: Country.
        - name: postCode
          in: query
          description: Post code.
          required: false
          schema:
            type: string
            description: Post code.
      responses:
        '200':
          description: Successful operation
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NearestLocationsSearchResultDto'
components:
  schemas:
    NearestLocationsSearchResultDto:
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique, unchangeable system generated identifier (alphanumeric) for
            the location.
        name:
          type: string
          description: Location name.
        straightLineDistanceKilometers:
          type: number
          description: Distance (as the crow flies) in km to the location.
          format: double
      description: >-
        Returns all the nearest Point of Interest (POI) locations to a search
        point. The number returned is restricted to the maximum specified. The
        locations returned are ordered based on distance from the specified
        search point.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````