Places, regions and fraud checks

Every location, with where it is and whether to trust it.

Each location you send comes back with the place, country and state it's in. Visits and border crossings become events like any geofence, and fraud checks flag fixes that jump too far, too fast, or come from a mocked GPS.

What you get

  • Place visits

    Places are OpenStreetMap points of interest, with chains from brand tags and categories like cafe or airport, plus places you add yourself. Filter visits to the chains and categories you care about.

  • Countries and states

    Every country worldwide, with its flag, and states or provinces in the US, Canada, Australia, Brazil, China, India, Indonesia, Russia and South Africa. Lookups take about a millisecond.

  • Accurate at the coast

    Boundaries are simplified, so a fix on a harbour or a bridge matches the nearest region within 25 km instead of falling into the sea.

  • Fraud checks

    Impossible jumps (over 5 km and faster than 1,200 km/h by default), mocked locations reported by the device, inaccurate fixes, and country allow and block lists. Block users for a while or for good.

  • Beacons

    Register iBeacon and Eddystone beacons and get entry and exit events from the beacons each track reports.

  • Context without tracking

    GET /v1/context answers for any point without storing anything: geofences, place, country and state.

Try it

Copy this, swap in a key from your project, and run it.

Request
curl "https://api.mapsocket.com/v1/context?coordinates=40.7411,-73.9897" -H "Authorization: pk_live_…"
Response
{
  "geofences": [{ "tag": "store", "externalId": "flatiron" }],
  "place": { "name": "Corner Café", "categories": ["cafe", "food-beverage"] },
  "country": { "code": "US", "name": "United States of America", "flag": "🇺🇸", "allowed": true },
  "state": { "code": "NY", "name": "New York" }
}

Good to know

  • Places come from OpenStreetMap, loaded area by area. Coverage depends on OpenStreetMap there, and areas that haven't been loaded have no places.
  • Mocked-location detection trusts the device's own flag. VPN and proxy detection aren't available.
  • No postal codes or DMA regions.

Read more