APIHub
Back to Explore

Miataru

The Miataru API lets devices post their current coordinates and obtain location data for a given device. It provides endpoints to fetch the latest location (including GeoJSON), the device’s location history, and a record of visitors who have requested that information.

Geocoding
none
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

936ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
POST

/GetLocation

To retrieve a specific devices latest known location the /GetLocation method is used. Please note that the MiataruConfig portion is optional. RequestMiataruDeviceID should be the ID of the device the request is sent from (or an identifier like an URL).

GET

/GetLocationGeoJSON/{deviceID}

Retrieves a devices Location in GeoJSON format.

  • deviceID (path, required) — the unique device ID of the device the location is requested from
POST

/GetLocationHistory

Location History is stored on the server only if the client told the server to do so using the “EnableLocationHistory” setting in the Location Update requests. For transitions of enabling/disabling that functionality - Everytime a Location Update is received by the server with “EnableLocationHistory=false” the server removes all stored Location History till that point. There is a server-side setting that controls up to how many Location Updates the server is storing in the Location History before it removes the oldest one. To request the Location History of a particular device the client sends the following POST request to the GetLocationHistory service URL. Please note that the MiataruConfig portion is optional. RequestMiataruDeviceID should be the ID of the device the request is sent from (or an identifier like an URL).

POST

/GetVisitorHistory

Visitor History is stored on the server with every request to the location or location history information of a device. There is a server-side setting that controls up to how many Visitors the server is storing in the Visitor History before it removes the oldest one. To request the Visitor History of a particular device the client sends the following POST request to the GetVisitorHistory service URL.

POST

/UpdateLocation

This method is used to update the location of a device. The device does not need to be known already to the Miataru server but it rather creates a unique identifier for itself in the client application. This unique identifier, or device ID is then used to address this particular device.

5 endpoints auto-detected

curl -X POST \
  "https://service.miataru.com/v1/GetLocation"

service.miataru.com · HTTPS only