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

Necessary Cookies
These cookies are necessary for this website to function correctly. They are set when you perform certain actions on the site, such as creating an account, logging in, changing your privacy preferences or submitting a form. You can block these cookies in your browser, but this will stop parts of the site from working properly.
Functional Cookies
These cookies allow the website to provide extra functionality and more personalised experiences. They may be set by us or by third party providers whose services we have added to our pages. If you choose not to allow these cookies, these services may not work correctly.
Analytical Cookies
These cookies record anonymous data on how visitors use our website to help us monitor how well our website works. This data includes how many people have looked at specific pages, how long visitors stay on the site, and what devices they use. We use this data to identify changes that we could make to improve your experience and make our website more efficient.
Marketing Cookies
We set some cookies so you are shown more relevant marketing content. These include cookies from third-party advertising networks to show you different adverts on their services if you have previously visited our site. If you choose not to allow these cookies, you may experience less relevant advertising on other sites.