# Beacon Scanner Start Ranging

Starts Ranging a region to detect the proximity and other detailed information of that region.

{% hint style="info" %}
Beacons are a class of BLE devices. Kalipso Supports Eddystone and iBeacon. Nomenclature from Eddystone to iBeacon may vary. Please read notes.
{% endhint %}

Action available for the following operating systems:

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MGNvrygahkCuEdVVkIq%2F-MGNwLqiqP4r-AXo-0B4%2FTodos%20menos%20IWindows%20CE%20E%20Mobile.PNG?alt=media\&token=ec0ed475-840e-4c43-bbd0-838f1de62214)

### Parameters

* **Region Code** *\<string>*
* **Beacon Type** *\<numeric>*
  * 1 - iBeacon&#x20;
  * 2 - Eddystone

&#x20;*iBeacon*

* **ID1 UUID** *\<String>*
* **ID2 Major** *\<numeric>*
* **ID3 Minor** *\<numeric>*

&#x20;*Eddystone*

* **ID1 Namespace ID** *\<String>*
* **ID2 Instance ID** *\<String>*
* **ID3 Minor** *\<String>*

{% hint style="info" %}
The concept of ranging a region is to receive imediate information about that region, with all the information specified in the call to **Beacon Scanner Initialize** being returned in a normally high rate of triggered events.
{% endhint %}

{% hint style="info" %}
Normally you start by monitoring a region, when when you detect that the region has been entered you can start Ranging for the same region, or for new regions with more specific IDs to get more information about the region/beacons, like distance etc.
{% endhint %}

{% hint style="info" %}
A region is an abstract concept that can represent a single beacon or a group of beacons. For example if you specify a Region Code for iBeacon and you fill in only the **ID1 (UUID)** parameter, all the beacons that have that UUID independently of their major or minor IDs will be considered to belong to that region. But if you specify all 3 IDs (UUID, Major and Minor), then the region will actually only target that specific beacon. The same concept can be applied to Eddystone.
{% endhint %}

{% hint style="info" %}
On iOS, for iBeacons you have to specify at lest the UUID, you cannot specify a region that is valid for all beacons.
{% endhint %}

{% hint style="info" %}
To range Eddystone beacons that only transmit the URL frame you need to specify a region with empty IDs. This happens because the URL frame does not have Eddystone ID information.
{% endhint %}

{% hint style="info" %}
If you call this action with a region code that already existed, that region will be replaced by this one.
{% endhint %}