Documentation

Radar is location data infrastructure. You can use our API and SDK to build a wide range of location-based product and service experiences, including curbside pickup and delivery tracking, store locators, address autocomplete, location-based content and notifications, and more.

In this overview, we introduce Radar's products, including:

  • Geofencing, with support for polygon geofences, isochrone geofences, out-of-the-box geofences for places and regions, and more.
  • Geo APIs, including flexible and affordable geocoding, search, and distance APIs with high-quality address and place data.
  • Last Mile, an end-to-end trip tracking and ETA solution for curbside and in-store pickup.

We also introduce the SDK, the API, integrations, and toolkit apps.

Quickstart

Want to get started quickly? Follow these three steps:

  1. Configure geofencing. Create custom geofences, enable Places (place, chain, and category detection), enable Regions (country, state, DMA, and postal code detection), or enable Insights (home, work, and traveling detection).

  2. Integrate the Radar SDK or API into your app or website. Integrate the SDK or API. Or, before integrating, test geofencing with our toolkit apps for iOS and Android.

  3. Enable integrations. Create a webhook or enable server-side integrations to send Radar events and user context to other systems.

Geofencing

Geofencing turns location data into context and events. Use geofencing to build contextual app experiences.

Geofences

Radar geofencing is more powerful than native iOS or Android geofencing, with cross-platform support for unlimited geofences, polygon geofences, isochrone geofences, and more.

Geofences provides the following user context:

{
  geofences: [
    {
      tag: "store",
      externalId: "123",
      description: "Store #123",
      metadata: {
        parking: false
      }
    }
  ]
}

Geofences also provides the following events:

  • user.entered_geofence
  • user.exited_geofence

Learn more about Geofences.

Places

Places uses our place database to detect when a user visits a place, chain, or category, even if you haven't set up geofences for those places.

Places provides the following user context:

{
  place: {
    name: "Starbucks",
    chain: {
      name: "Starbucks",
      slug: "starbucks",
      externalId: "123",
      metadata: {
        customFlag: true
      }
    },
    categories: [
      "food-beverage",
      "coffee-shop"
    ],
    location: {
      type: "Point",
      coordinates: [
        -73.977797,
        40.783826
      ]
    }
  }
}

Places also provides the following events:

  • user.entered_place
  • user.exited_place
  • user.nearby_place_chain

Learn more about Places.

Regions

Regions detects a user's country, state, DMA (media market), or postal code.

Regions provides the following user context:

{
  country: {
    code: "US",
    name: "United States"
  },
  state: {
    code: "MD",
    name: "Maryland"
  },
  dma: {
    code: "26",
    name: "Baltimore"
  },
  postalCode: {
    code: "21014"
  }
}

Regions also provides the following events:

  • user.entered_region_country
  • user.exited_region_country
  • user.entered_region_state
  • user.exited_region_state
  • user.entered_region_dma
  • user.exited_region_dma

Learn more about Regions.

Insights

Insights predicts a user's home and work locations and detects when a user is at home, at work, traveling, or commuting.

Insights provides the following user context:

{
  insights: {
    state: {
      home: false,
      office: false,
      traveling: true,
      commuting: false
    },
    locations: [
      {
        type: "home",
        coordinates: [
          -73.977797,
          40.783826
        ],
        confidence: 3
      },
      {
        type: "office",
        coordinates: [
          -73.977797,
          40.783826
        ],
        confidence: 3
    ]
  }
}

Insights also provides the following events:

  • user.entered_home
  • user.exited_home
  • user.entered_office
  • user.exited_office
  • user.started_traveling
  • user.stopped_traveling
  • user.started_commuting
  • user.stopped_commuting

Learn more about Insights.

Geo APIs

Use our geo APIs to build location-based app experiences with high-quality address and place data. Geo APIs include:

  • Forward geocoding, which converts address to coordinates.
  • Reverse geocoding, which converts coordinates to address.
  • IP geocoding, which converts IP address to city, state, and country.
  • Autocomplete, which autocompletes partial addresses and place names, sorted by relevance.
  • User search, which searches for users near a location, sorted by distance.
  • Geofence search, which searches for geofences near a location, filtered by tag, sorted by distance.
  • Place search, which searches for places near a location, filtered by chains, categories, or groups, sorted by distance.
  • Distance, which calculates the travel distance and duration between two locations for travel modes including foot, bike, and car.
  • Matrix, which calculates the travel distances and durations between multiple origins and destinations.

Last Mile

Last Mile is an end-to-end trip tracking and ETA solution for curbside and in-store pickup.

Learn more about Last Mile.

Developer tools

Integrate Radar into your apps and websites using the SDK, the API, and integrations.

SDK

Integrate the SDK into your iOS and Android apps to start tracking users and generating events. The SDK abstracts away cross-platform differences between location services, allowing you to add location context and tracking to your apps with just a few lines of code.

Learn more about the SDK.

API

Use the Radar APIs as building blocks for location-based products and services. Or, use Radar APIs to manage your Radar data, including users, geofences, and events.

Learn more about the API.

Integrations

Radar supports a number of server-side integrations. Event integrations like webhooks, mParticle, Segment, Braze, and Airship allow you to send events from Radar to other systems. Geofence integrations like Yext allow you to sync geofences from other systems to Radar.

Learn more about integrations.

Toolkit

You can use our Radar Toolkit apps for iOS and Android to test Radar geofencing before integrating the SDK, or to test your implementation of Radar side-by-side with a complete implementation.

Learn more about the toolkit apps.