Google Maps API Key

As of June 22nd, 2016 the Google Maps API requires an API key.

This means that if you are hosting farmOS yourself, you need to create an API key in order to use the Google Maps base layers in farmOS maps. If an API key is not provided during installation, OpenStreetMap will be used as the default base layer instead.

Anyone who had a farmOS site installed before June 22nd, 2016, and was actively using it, was automatically grandfathered in and does not need an API key:

Existing applications have been grandfathered based on their current usage to ensure that they continue to function both now and in the future. We will also be proactively contacting all existing API key users who, based on usage growth patterns, may be impacted in the future. If you’re an existing user, please take the time to read our Policy Update for Standard Plan summary for details on how each of these changes might affect your implementation.

To create an API key and add it to your farmOS, do the following:

1. Generate a Browser Key

2. Enable Google Maps Javascript API

3. Create Billing Account

The Google Maps JavaScript API is effectively free for personal use (up to tens of thousands of page views per month) but as of July 2018 it does require that you attach a credit card.

Go to and follow the instructions to create a new billing account (or link an existing one)

4. Enter the key into the farmOS Map configuration

a) If you are installing farmOS for the first time, there is a field for entering the Google Maps API key during the "Configure farmOS" step.

b) If you have already installed farmOS, you can enter the API key in the map configuration form at /admin/config/farm/map.

Note that according to Google it may take a couple of minutes before a new API key becomes active.