A Custom POI is in general the same as a normal Points Of Interest but it allows you to create your own points in the world. Additionally, it can hold your own data in a "payload". There are two different kinds of custom Points of Interest.

1. POIs uploaded by the project owner in the backend

2. User generated POIs

When allowing users to generate custom POIs, you can use the Tag Suggestions method to obtain and present eligible Names for the new POIs to the user.

To generate a custom POI and send it to COALA, you can orientate yourself on the following example script: 

{

public void OnError (string message)

{

Thoughtfish.Coala.Core.Network.Custom.POI.OnAnswerReceived -= OnSuccess;

Thoughtfish.Coala.Core.Network.Custom.POI.OnError -= OnError;

//log as an example reaction

Debug.LogError( message );

}

public void OnSuccess(string message, GPSCoordinates coordinates, string payload)

{

Thoughtfish.Coala.Core.Network.Custom.POI.OnAnswerReceived -= OnSuccess;

Thoughtfish.Coala.Core.Network.Custom.POI.OnError -= OnError;

//log as an example reaction

Debug.Log( message );

}

// just as an example in this start method

public void Start()

{

Thoughtfish.Coala.Core.Network.Custom.POI.OnAnswerReceived += OnSuccess;

Thoughtfish.Coala.Core.Network.Custom.POI.OnError += OnError;

GPSCoordinates coordinates = Thoughtfish.Coala.GPS.Provider.GPSPosition;

Thoughtfish.Coala.Core.Network.Custom.POI.Add(

"default", 

coordinates.lon, coordinates.lat, 

"{\"username\":\"example\",\"level\":3,\"avatarData\"{\"hatAssetIndex\":0, \"hairAssetIndex\":7, \"faceAssetIndex\":7, \"hairColorIndex\":4}}");

}

}

To render custom POIs or use their Payload for other tasks, you have to implement your own "ICustomPoiGenerationLogic", or use the default logic: