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.
Latency
936ms p95
Uptime
100.0% 30d
Playground
Verified
live
Endpoints
/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).
/GetLocationGeoJSON/{deviceID}
Retrieves a devices Location in GeoJSON format.
/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).
/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.
/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