Support for location-triggered notifications can be achieved in the following ways.

Target by country

Country is automatically tracked based on the IP Address. Use the country Data Filter in Segments or API filters.

Target by location (radius around a latitude & longitude point)

If your mobile app collects location data and you share it with OneSignal, the location points will update automatically around every 5 minutes based on the location permission granted by the user.

🔨

Developer setup required

Your app must get permission from the user to track location and that location must be shared with OneSignal for location points to update. See our Mobile SDK location reference for details on getting setup.

Once location is set, messages can be sent based on a radius around the location points using the location filter in Segments or our Create message API.

Web push latitude and longitude tracking

OneSignal does not automatically collect location points on web push. You can setup your site to prompt users for Location Tracking and add Data Tags to set it within OneSignal. Here is a great Medium Post about this.

If getting and setting the location points with OneSignal sendTags method, assign "longitude" and "latitude" tags. For example, you could set "long"="37.160" and "lat"="-117.773".

Then you can send a message to users in a segment based on these tags.

For example, define a segment with tags "long" > 37, "long" < 38, "lat" > -118, "lat" < -117 to create a square target region containing users with location tags in that range.

You can do this manually via the New Messages Page, automatically via the Server REST API, or automatically via the Automated Messages Page.

Target by city or provided location

OneSignal does not provide a way to track city or area codes. This data is usually collected in the following ways:

• User inputs a city or location into a field on your site/app.
• Prompt User for Location Tracking on Web and use Google Maps Reverse Geocoding API. Here is a great Medium Post about this.

You can send this data to OneSignal as Data Tags.

We have also partnered with Radar if you want to integrate with their service.

Target based on a Geofence Trigger

We have also partnered with Radar if you want to integrate with their services.

Radar is the leading geofencing and location tracking platform. You can use Radar's SDKs and APIs to build a wide range of location-based product and service experiences, including pickup and delivery tracking, location-triggered notifications, location verification, store locators, address autocomplete, and more. For more information about our integration, visit the Radar Docs or contact the Radar team to learn more.