Miataru

miataru · Location

Location No Auth Free & Open location

The Miataru API is very simple and straight forward. Generally you're posting (HTTP POST) a JSON formatted request to a service method locations and you get back a JSON formatted answer. Please take into consideration that this has the request-for-comment status and that it can change while there's work done on client and server applications. Versioning therefore is done by prepending the version number - /v1/ for version 1 - to the method call.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET getLocationGeoJSON

Retrieves a devices Location in GeoJSON format.

https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationGeoJSON/{deviceID}";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

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).

https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation"

import requests
response = requests.post(
    "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation';

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation"
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocation";
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

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

https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory"

import requests
response = requests.post(
    "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory';

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory"
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/miataru.com/1.0.0/GetLocationHistory";
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Miataru?

Miataru is a Location API. Developers commonly use location APIs for:

tracking assets and vehicles in real time
building delivery and logistics apps
finding nearby businesses or services
geo-fencing and location-based notifications
address validation and autocomplete

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Miataru is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗