Skip to main content
Location access is how you control two things at a site: who can see it, and who can charge there. You set both through a location’s own settings and the charge keys and vouchers that grant access to it.

Overview

Access has two aspects, and every mechanism below controls one or both:

Visibility

Whether a driver can find the location in an app or map.

Authorisation

Whether a driver can actually start a charging session there.
A location’s own settings set the baseline, and charge keys and vouchers layer on top to open access to specific drivers. Each mechanism has a home of its own; this page is how they fit together.

Who can see a location

Two publishing settings decide visibility, and they work independently:
  • Publicly available lists the location in Spirii Go and the maps where Spirii shares location data, so any driver can find it.
  • Hidden from charging apps removes that listing without changing who can charge — a driver who already knows the site is there, and carries a valid charge key, can still use it.
Combined, they give three practical states: Enabled for roaming extends visibility further, publishing the location to drivers on other networks through Spirii’s roaming partners. See Roaming connection for how that works. These settings are configured on the location itself — see Location configuration.

Who can charge

Whether a driver can start a session comes down to the charge key they present and the access tied to the location.
A charge key authorises charging at any public location in the Spirii network, and on roaming networks too when the location has roaming enabled. This is the default path for a public site: any registered, active charge key works.
A charge key group restricts a set of locations to the charge keys inside it. Only those charge keys can authorise there, and they can do so even when the location isn’t public — a charge key group always grants its members access. It’s how you make a depot exclusive to your own fleet’s keys.
A voucher grants a driver both access and a specific rate at a defined set of locations. A driver enters the voucher code in the app, or you link it to a charge key, and it opens access even where the location is private. See Voucher access for the full mechanism.
Chargers can also require authentication or allow charging to start on plug-in, and support methods such as Plug & Charge. Those sit with the charge key rather than the location — Charge key authentication covers them.

How the settings combine

The mechanisms follow a clear order of precedence, and it’s worth holding the whole picture in view, since a single setting rarely tells you who can charge. On a public location, any registered charge key can charge. If you’ve set opening hours, that holds during open hours; outside them, the site narrows to drivers whose charge key is in a bound charge key group, or who hold a voucher. On a location that isn’t public, an ordinary charge key is declined. Only two things get a driver in: membership of a charge key group bound to the location, or a valid voucher.
Vouchers and charge key groups always grant access. They override the public setting and opening hours alike — so a driver with either can charge at a location even when it’s private or closed to the public. Treat them as the deliberate exceptions to a location’s general rules.

Dependencies & limitations

  • Vouchers and charge key groups override location settings. They’re absolute grants, so a location’s public setting and opening hours don’t restrict a driver who holds one. Keep that in mind when you rely on opening hours to limit access.
  • A non-public location declines ordinary charge keys. Only a bound charge key group or a voucher authorises there; a plain registered charge key isn’t enough.
  • Residential access works differently. Private, residential-type charge boxes use their own sharing and app-user mechanisms, set from Spirii Go rather than the location settings here.

Charge keys

The keys that authorise charging, and the groups that scope them to locations.

Vouchers

Codes that grant access and a set rate, overriding a location’s own rules.

Voucher access

How vouchers open access and pricing to specific drivers.

Roaming connection

Extend visibility and access to drivers on other networks.

Location configuration

Where a location’s publishing settings and opening hours are set.

Charge key authentication

How a charge key authenticates a session, and the methods a charger accepts.