Location Sharing
Location sharing is an option that can be turned on if want to share your location with someone, or have a group of people connected so that you can see the whole group together. You can see locations within the app or through the website interface. Location sharing is possible anywhere that you have a data connection. If you have a satellite (starlink) enabled data plan then you will be able to share your location using this network as well. For REST api options see below. Contact us for managed device options.
How do I use it?
Turning on location sharing is simple.
- Look for ‘Location Sharing’ on the Settings page.
- Choose a Channel ID. This can be any string of characters and numbers. Anyone who uses this same Channel ID will be part of your group so choose a simple name for convenience or a complicated one for more privacy.
- Choose a Display Name. This can be any text and doesn’t need to be a real name. This is what other people will see.
- Turn it on with the ‘Share my location’ button. Also turn on ‘Monitor this channel’ if you want to see locations of other people on the channel.
To stop sharing your location, turn off ‘Share my location’

How does it work?
Location sharing is based on Channels. Your phone sends your location and channel Id to our server, and this is shared with anyone who uses the same channel ID and you can see anyone who is sharing their location on that channel. It works across both Android and iPhone devices.
If you use a unique or random channel then only people you share that channel ID with will be able to see your location. If you choose a common ID or share it publicly then other people may be able to see your location or join the same channel. You don’t own or control a channel ID by choosing it!
Your location can be shared from anywhere that you have network access including over satellite networks if you have that enabled on your phone. If you lose coverage then no location update is possible. Only your latest known location will be displayed.
You can monitor group locations either in the app (with monitor this channel turned on), or at home through a computer using the ‘Live Monitoring’ link on this website. You don’t need to be sharing your own location or even have a copy of the app to see the locations, you only need to know the channel ID.
Updates are every minute by default, subject to network availability. The update frequency can be reduced if desired. If the network becomes unavailable then no locations will be shared. When the network becomes available again then locations will be updated within the next update period. Locations will continue to be shared in the background while you use other apps or when the phone is locked. The app does not have to remain open.

Is this a safety feature?
The NZTopo50 location sharing feature is not intended to provide or replace any safety functions or processes. It is not a monitored system that will respond to any activity or lack of activity, and successful location sharing depends on a combination of factors including network connectivity that are not guaranteed to be available. Users should have their own separate safety backup plans including for example independent methods of communication, raising an alarm (e.g. PLB’s), and fallback plans.
What does it cost?
There is no additional cost to using the location sharing service beyond the initial app purchase cost, and monitoring of a channel can be done even without the app. You will however need a network connection through your phone provider to share your location. You will need a subscription that includes satellite connectivity if you want it to operate in areas where there is no cell phone coverage.
There is an option for those who feel that it is appropriate to contribute further to operating costs and ongoing app development. This can be done within the app or contact us for other options.
How well does it work?
Location sharing is only as good as the network connection available to you. The app works across Starlink networks through both One NZ and Spark if you have satellite network access enabled.
It is early days for good benchmarking but indications are that in remote areas that are relatively open to the sky satellite connectivity is very good, location updates are reliable, and battery life is reasonable. Similarly for more urban locations where cellular connections are reliable and signals are strong. In intermediate locations however where cellular signals are patchy, a phone is likely to keep trying to use cellular connections that are marginal or non-existent rather than switch to the satellite network. In this case location updates may be irregular or may fail for long periods, and battery consumption is also likely to be higher as the phone tries to connect to weak networks. Battery life can be controlled by setting the phone to flight mode in places where location updates are not needed or are unlikely to be successful.
Advanced settings
Tap the ‘More Options’ button for advanced settings.
Adjust the time interval for location updates as required. Less frequent updates may help with battery life.
Use the Secondary channel option to share your location on another channel at the same time. Location sharing needs to be turned on and locations will be sent to anyone using either of the primary or secondary channels. Clear the text in this box to stop sharing on the secondary channel.
‘Share location using device ID’ can be turned on if you want your shared locations accessibly through the device ID. This is useful, for example, for making your location accessible to third party sharing and/or event management sites (e.g. the same as Garmin in-reach MapShare/Live Tracking). The device ID share button will create your unique link to your device location.

Remote viewing
For those at home, group locations can be viewed through a web browser through our website. You will need to know the channel ID. The Channel ID share button in the app can be used to share a link to the website view, or to share the channel with other app users.
Notes on data privacy and how it works
If you leave location sharing turned off then no location information is shared from within the app!
If you choose to turn it on then your GPS location (easting, northing, altitude) along with the Channel ID, the display name you have chosen, and a random id number, are sent to our server. This information is anonymous and we have no way to connect the information sent with you personally (you’ll have noticed that you don’t need an account to use the NZTopo50 app). The random id number is truly random and can’t be connected to either you or your phone and is only used to connect one location update with previous ones from the same phone and differentiate it from other people sharing locations on the same channel. The text you use for your display name is shared but can be any string of characters and numbers and doesn’t need to be unique or include any real names (unless that is what you want).
Once locations are received by our server, they are then shared with anyone who monitors the same channel ID. Channel ID’s are not published publicly anywhere so if you choose an obscure channel ID name and only share it with closed contacts then it is unlikely that anyone else will randomly obtain access to those locations. If you choose a random 24 character channel, or use the generate ID button, then this will be unguessable and only people you share it with will see your location.
Channel ID is the only filter used for distributing locations. By choosing a channel ID you don’t own or control it, and anyone using the same ID will share this channel with you. There is no Channel ‘owner’ who can choose who uses a particular channel.
Only the most recent location shared is stored on our system, and if no further locations are updated in a 24 hour period then this location is removed as well.
As soon as you turn off location sharing then only your last shared location will be visible on the channel, and this will be removed after 24 hours. If you want to remove the old location immediately then it is possible to do this by choosing your own unique channel and sharing an update on that channel. This will replace the location on the old channel.
Other systems (like the map interface on this website) will also be able to request location information for a specific Channel ID. This works with the same restrictions as the phone app, and requires a known channel ID in advance.
REST api
Group locations can be accessed through a public api. The server is located here: https://locationserver.sqrl.net
| Endpoint | Access | Description |
| /ping | public | |
| /share/channel/:ch | public | returns a GeoJSON feature collection of WGS84 locations, as well as NZTM2000 easting, northing, altitude |
| /share/user/:uid | public | returns a GeoJSON feature with WGS84 location for the given device ID. Device ID access needs to be enabled in the app. |
If you need to manage a group of devices then talk to us for an api key. ‘Share location using device ID’ must be turned on in the app for each device, and location sharing needs to be activated by the device user. The group management api can be used to share locations between a group of controlled devices. This can be done in parallel with any channel sharing enabled on the device, or can be made exclusive to the group overriding channel settings.
The api key is included in the bearer header. Device locations can be monitored through the uid public endpoint.
| Method | Endpoint | Description | Body | Response |
GET | /groups | List groups owned by this API key | None | { "label": "...", "groups": [...] } |
| GET | /share/group/:group_id | List locations in group | {“group_id”: “…” } | GeoJSON feature collection |
PATCH | /apikey/label | Rename current API key label | { "label": "..." } | { "ok": true, "label": "..." } |
POST | /group/create | Create a new group | { "name": "...", "exclusive": false } | { "ok": true, "group_id": "...", "exclusive": false } |
PATCH | /group/:group_id | Update group name/exclusive flag | { "name": "...", "exclusive": false } | { "ok": true } |
DELETE | /group/:group_id | Delete a group | None | { "ok": true } |
POST | /group/:group_id/member | Add device (uid) to group | { "uid": "..." } | { "ok": true } |
DELETE | /group/:group_id/member/:uid | Remove device (uid) from group | None | { "ok": true } |