Overview

EILLocationBuilder is a builder object for creating EILLocation objects.

In order to construct a new location you need to:

• set the shape of the location and its orientation
• add details such as beacons, walls, doors on boundary segments

The shape of the location is defined by its boundary points. For example, consider a square defined by points (0,0), (0,5), (5,5), (5,0) along with its orientation with respect to the magnetic north.

[locationBuilder setLocationBoundaryPoints:@[
    [EILPoint pointWithX:0 y:0],
    [EILPoint pointWithX:0 y:5],
    [EILPoint pointWithX:5 y:5],
    [EILPoint pointWithX:5 y:0]]];

[locationBuilder setLocationOrientation:0];

Points that define shape of location also define its boundary segments. They are indexed in the same order as the points. There are following 4 segments: [(0,0), (0,5)], [(0,5), (5,5)], [(5,5), (5,0)], [(5,0), (0,0)].

The next step is to place beacons, doors on the boundary segments of the location:

[locationBuilder addBeaconWithIdentifier:@"63d4819e6a1d"
                  atBoundarySegmentIndex:0
                              inDistance:2
                                fromSide:EILLocationBuilderLeftSide];