Proof of Location API

The Trusted Location API currently provides only one endpoint, more will be added in the future.

Proof of location in a circular geo-fence

API documentation

Proves the presence within a certain distance from a specific GPS location at a certain time.

This service allows to prove that the user has been within a certain distance from a specific GPS location, within time range [t1, t2]. Requires that the user has the IoTeX ioPay wallet installed, and enabled the Metapebble plugin.Tip: You can view the input and output data schame in the "Schema" tab and expand them.

POST/api/pol

Body

application/json

signature*string

The signature of the SIWE message created by the 'owner' address.

message*string

A SIWE (Sign In With Ethereum) message.

ownerstring

The wallet address of the user of which you want to prove the location. This must be the IoTeX wallet address that the user associated to Metapebble.

locationsarray of object

Response

200default

Successful response

Body

application/json

ok*enum

true

data*array of object

Request

JavaScriptCurl

const response = await fetch('/api/pol', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "signature": "text",
      "message": "text"
    }),
});
const data = await response.json();

Response

{
  "ok": true,
  "data": [
    {
      "scaled_latitude": 0,
      "scaled_longitude": 0,
      "from": 0,
      "to": 0,
      "signature": "text",
      "devicehash": "text",
      "imei": "text"
    }
  ]
}

Mainnet

Mainnet applications can use the mainnet verifier contract to validate proofs of location obtained from this endpoint:

https://geo.w3bstream.com/api/pol

Testnet

Testnet applications can use the testnet verifier contract to validate proofs of location obtained from this endpoint:

https://geo-test.w3bstream.com/api/pol

Please notice that the testnet API endpoint generates proofs based on location data that is not "trusted" (i.e., test locations data generated by a script for development and test purposes). Therefore, any attempt to validate those proofs on the mainnet validator contract will fail.

Make sure you query the mainnet API for proofs of location that are supposed to be used in production.