determineLocation

This function can be called in the site’s Javascript to determine the location of the visitor of the site.

To be able to call this function, somewhere on the site {% include_plate_scripts "determine_location" %} must be called (e.g. the head section).

Read more about include_plate_scripts here.

The function returns a Javascript Promise, which you can use in the following way:

(() => determineLocation()
  .then(res => console.log(res.country_code))
  .catch(err => console.log(err.message))
)()

The response if successful is a JSON (returned in the then):

{ 
  'country_code': 'NL', 
  'name': 'Netherlands' 
}

The country code is the same as defined in ISO 3166 Standard Country Codes.

If an error occurs (this will be in the catch):

{ 
  'message': '<error message>' 
}

An error is returned in case the network request fails, or if the country could not be determined.