Skip to main content
Version: 5.11.6

UpdateLocationProperties

public BackendReturnObject UpdateLocationProperties();

Description

Updates the IP-based country information cached within BACKND SDK.

When BACKND's inspector value (Auto Load Location Properties) is checked or autoLoadLocationProperties in BackendCustomSettings is declared true, call the asynchronous method upon initialization, to load and cache the current country information.

The cached value is implemented only when logging in (including token reissuance), and if login is successful, the country information is changed to the matching one.

If an error occurs because the transference to the server has failed upon initialization, you can call the method and synchronize it again.

Country may not be loaded for devices using VPN.

Country information can be called with City, Country, Region, and Language inside Backend.LocationProperties.

Example

Synchronous

Backend.LocationProperties.UpdateLocationProperties();

Debug.Log("Country name : " + Backend.LocationProperties.Country);
Debug.Log("City name : " + Backend.LocationProperties.City);
Debug.Log("Region name : " + Backend.LocationProperties.Region);
Debug.Log("Language name : " + Backend.LocationProperties.Language);

Asynchronous

Backend.LocationProperties.UpdateLocationProperties(callback=>
{
Debug.Log("Country name : " + Backend.LocationProperties.Country);
Debug.Log("City name : " + Backend.LocationProperties.City);
Debug.Log("Region name : " + Backend.LocationProperties.Region);
Debug.Log("Language name : " + Backend.LocationProperties.Language);
});

SendQueue

SendQueue.Enqueue(Backend.LocationProperties.UpdateLocationProperties, callback => 
{
Debug.Log("Country name : " + Backend.LocationProperties.Country);
Debug.Log("City name : " + Backend.LocationProperties.City);
Debug.Log("Region name : " + Backend.LocationProperties.Region);
Debug.Log("Language name : " + Backend.LocationProperties.Language);
});

ReturnCase

Success cases

When the synchronization is successful
statusCode : 204
returnValue : Success

Error cases

When VPN is enabled
statusCode : 400
errorCode : HttpRequestException