Skip to main content
Browse Documentation

Location field

Created by Contensis product team, last modified by r.bromley on 22 Sep 2020

You can use the location field editor to provide an accurate geographical location within an entry. A location can be set using the search, which is powered by Google Places, or by navigating with the map.

Fine adjustments to location can be set by dragging the map pin to an exact position, or by entering latitude and longitude coordinates.

Appearance

An example of a location editor

Settings

Setting name Summary
Name A text label to identify the field in an entry.
Field ID A sanitised name to be used by the API.
Default value The default value allows you to set the default location for an entry.
Read only Prevents authors from editing the field in the entry editor.
Allow multiple items to be added Sets the field to be repeatable, allowing an author to create a list of items.

Supported validation

This field editor supports the following validation methods:

Properties

Common properties

Property name Summary
Content guidelines Provides guidance to an author for the expected content that the field should contain.
Size Determines the size of the rendered editor in the entry editor. The default value is set to Medium.

Map centre position

If you want to set your map to be centred around a location other than the default of London, you can use this property to set where the map should be centred.

Show latitude and longitude

It's possible to enter exact latitude and longitude values into the entry editor. However, most authors will want to use the search or set a location using the map.

This setting determines if the latitude and longitude number fields should be shown in the entry editor. These fields are not displayed by default.

Show search

If you want your authors to manually set the location using the navigation controls, you can disable the search box in the field editor. The search box is enabled by default.

Place search limitations

The location field editor uses the Google Places API Web Service to carry out location searches. There is a default limit set by Google of 1,000 free requests per 24 hour period.

Each text search counts as 10 requests to this service. The default limit in a 24 hour period could quickly be met if your authors regularly use location searches in their entries.

Increasing the limit

To increase the limit to 150,000 requests you'll need to verify your identity with Google by adding your billing information through the Google developer console. Once billing information has been added you can create an API Key via the Google API Console. This API key can then be applied to the project setting Google_ApiKey_Places.

Note: The credit card details provided for billing are purely to validate identity. The card will not be charged for use of the Google Places API Web Service.

If you feel you need more than the 150,000 requests then you can purchase a Google Maps API premium plan.

Full details can be found at the Google Place API usage and billing site