---
title: "Request map information."
method: GET
path: "/map/fetch"
tags: ["Tracking|Vehicle Map Embedding"]
---

# Request map information.

`GET /map/fetch`

This endpoint enables you to retrieve the present and previous locations of trackers. It will provide the data
utilized by the embedded map. The autoRefresh duration is a parameter utilized for the map view. It is
not significant for your application. It's not recommended to regularly fetch the current position, both
to save resources and avoid hitting API rate limits.

## Query parameters

- `date` string
- `trackers[byIds][]` integer[]
- `trackers[byLicenseNumbers][]` string[]
- `trackers[byIdentifiers][]` string[]
- `trackers[byIdentificationNumbers][]` string[]
- `trackers[byImportKeys][]` string[]
- `trackers[importSource]` string
- `trackers[byName]` string
- `trackers[byDriver]` string
- `eventTypes[]` string[]

## Response `200`

Success Response:

- StandardMapFetchResponse
  - `trackers` object[] — The vehicles.
    - `id` integer — The internal vehicle ID.
    - `identifier` string — The customer-specific ID. (max. 64 characters)
    - `inventoryNumber` string — The inventory number. (max. 128 characters)
    - `licenseNumber` string — The vehicle license plate. (max. 255 characters)
    - `identificationNumber` string — The vehicle identification number. (max. 24 characters)
    - `importSource` string — External data source from which this vehicle originates. (max. 64 characters)
    - `importKey` string — External ID from the respective data source. (max. 64 characters)
    - `name` string — The vehicle name. (max. 255 characters)
    - `color` string — The defined route color.
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `iconUrl` string — The URL for the icon.
    - `iconSize` integer[] — The icon size in pixel.
    - `driverName` string — The driver name.
    - `sensors` object[] — The available sensors.
      - `id` integer — The internal sensor ID.
      - `name` string — The sensor name.
      - `type` string — The sensor type. | Value | Description | | ------------------------ | ------------------------------------------- | | ALTITUDE | Height | | SPEED | Speed | | DIRECTION | Direction | | GPS_SIGNAL_QUALITY | GPS signal strength (Number of satellites) | | GSM_SIGNAL_QUALITY | GSM signal strength | | POWER_SUPPLY_VOLTAGE | Voltage | | EMPLOYEE | Employee | | PIECE | Piece | | SECOND | Second | | MINUTE | Minute | | DEGREE | Degree | | MILLIVOLT | Millivolt | | METER | Meter | | METER_PER_SEC2 | Meter/s² | | KILOMETER | Kilometer | | KILOMETER_PER_HOUR | Kilometer/h | | LITER | Liter | | LITER_PER_100KM | Liter/100 km | | VOLT | Volt | | AMPERE | Ampere | | MILLIAMPERE | Milliampere | | PERCENT | Percent | | DEGREE_CELSIUS | Degrees Celsius (°C) | | BOOLEAN | On/Off | | ID | ID | | NUMBER | Number | | METER2 | Meter² | | HECTARE | Hectar |
    - `hasDriverKey` boolean — The current driver uses an iButton or RFID key.
    - `latLngBounds` ComponentGeocodingLatLngBoundsInterface — Represents a rectangle in geo coordinates
      - `minLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `maxLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
  - `trackPoints` object[] — The geo coordinate list.
    - `trackerId` integer — The internal vehicle ID to which this list belongs.
    - `data` object[] — The individual points.
      - `time` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `sensorValues` object[] — The sensor values.
        - `sensorId` integer — The sensor.
        - `value` number — The value.
        - `displayValue` string — The formatted value.
  - `events` object[] — The event list.
    - `trackerId` integer — The internal vehicle ID this list is linked to.
    - `data` object[] — The individual points.
      - `type` string — The event type | Value | Description | |--------------------------|--------------------------------------| | MOVE | Move | | STOP | Stop | | STAMP | Stamp | | IGNITION | Ignition | | SENSOR | Sensor |
      - `sensorValueTypeName` string — The event value type name.
      - `startTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `startLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `startProjectId` integer — The project the vehicle was located at the event start.
      - `endTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `endLatLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `endProjectId` integer — The project the vehicle was located at the event start.
      - `distance` integer — The driven distance in meters.
      - `employeeId` integer — For MOVE events the driver. For STAMP events the employee.
      - `beaconIds` integer — The beacon's IDs of the event.
  - `autoRefresh` integer — The configured refresh interval in seconds.

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)