Location SDK
Demo toolkit
API Reference
Overview
Cloud4Wi WiFi SDK empowers mobile apps with instant, automatic, and fully encrypted WiFi connection upon arrival to enabled locations, allowing app users to get a stable and fast connection for a smooth on-site experience.
Quickstart
Want to get started quickly? Follow these four steps:
- 1.
- 2.Setup WiFi network. Setup the WiFi locations and access points in your Cloud4Wi account and configure your WiFi hardware
- 3.Integrate the Cloud4Wi SDK into your app. Integrate the SDK. Or, before integrating, test WiFi connectivity with our toolkit apps for iOS and Android.
- 4.Enable integrations. Create a webhook or enable server-side connectors to send Cloud4Wi events and user context to other systems. Or, you can create a triggered message in Campaigns.
WiFi connectivity
Cloud4Wi WiFi SDK empowers mobile apps with instant, automatic and fully-encrypted WiFi connection upon arrival to enabled locations, empowering your app with a stable and fast connection to deliver a smooth on-site experience.
All your mobile users will be automatically connected and authenticated to the WiFi network as soon as they are in the rage of the network.
The WiFi SDK supports both standard WPA2-Enterprise profiles and Passpoint profiles.
Location Events
With Cloud4Wi WiFi SDK your app becomes aware when end users enter and visit any of your locations, and every on-site Event becomes an opportunity to deliver powerful location-based experiences or drive monetization.
The automatic connection to WiFi allows Cloud4Wi to detect precisely all the customer visits and interactions and push the relevant Events to your application systems via Webhooks or Connectors
Location Events are deterministic, overcoming the accuracy limitations of geofencing in indoor and high-dense urban environments.
No smartphone location permissions are required! User opt-in is collected with the consent experience you design in the app. The location is detected by the network, it doesn't require OS location services.
Privacy and compliance
The WiFi SDK does not require Location permissions from the operative system to work. However, the SDK processes personal data for certain purposes so privacy regulations might require that you collect the proper consent from the customer.
For example, you can promote the new service to your mobile users (with a notification, banner, or button) and collect their acknowledgment and consent when they enroll.
For new users, you can rely on your existing Privacy Policy to collect consent, make sure it covers the personal data categories and purposes involved with this new service.
Network compatibility and requirements
You need to use a WiFi vendor and device models that are compatible will the service and certified by Cloud4Wi.
Certified tested vendors for the WPA2 Enterprise mode so far:
- Cisco Meraki
- Cisco WLC, Cisco Catalyst 9800
- Ruckus
- Mikrotik
WPA2 Enterprise is a standard protocol, if the vendor is not listed among the tested ones, it is still very likely that is compatible with Cloud4Wi WiFi SDK. Please contact our team, we'll investigate the tech feasibility and develop the necessary integration if necessary.
Certified vendors for the Passpoint mode are:
- Cisco Meraki
- Cisco WLC
You need to add a dedicated SSID on your WiFi network (different from the one used for standard guest WiFi), configured with WPA2-Enterprise settings and (optionally) Hotspot 2.0. The additional SSID will be used only by mobile app users and Passpoint enabled users, and can also be hidden.
Mobile devices compatibility
The SDK is currently available for iOS and Android, however, it can be easily integrated into any app developed with non-native dev languages such as Flutter or React Native (our team will provide guidance on the process). The SDK is compatible with an Android OS starting for version 4.3 and iOS devices starting from iOS 11.0
The WPA2 Enterprise mode is compatible with all Android and iOS devices mentioned above.
The Passpoint mode is compatible with all iOS devices and with a subset of Android devices:
- starting from Android 12, Passpoint support is mandatory in all OEM vendors
- almost all devices with Android 10 and 11 support Passpoint
- for the oldest version of Android, the support of Passpoint is fragmented and depends on the device manufacturer. For example, Samsung phones support Passpoint starting from Android 8.
Last modified 1mo ago