Google services integration

This service is provided by a third party company. We don’t take any responsibility for any changes in how this service operates or works. Any issue with this service you need to discuss directly to company which provide it.

Google services are required in order to make booking software fully operational.
It is used to calculate distance between locations, geocode locations, get address suggestions, display map etc.
All these information are needed to calculate the journey price that will be displayed to customer during the booking process.

To make the integration, please follow the steps below.

  1. Register or use an existing Google developer account.
  2. Once you are logged in, please navigate to APIs & Services -> Credentials and create new project (enter a name you will recognise as your company).
  3. Now click in Create credentials -> API key and make a note of the auto generated key.
    In most cases you will use same API key for all services, in some instances you may use a different one for each service.
    Take those API keys and add to the software Settings -> Google -> add keys -> Save
  4. Next, navigate to APIs & Services -> Library and using search option find and enable each of the services listed below (one by one). Please see attached screenshots below for more details.
    • Directions API
    • Places API
    • Geocoding API
    • Maps JavaScript API
    • Maps Embed API
  5. Important! You also must enable billing profile for your project in Billing -> Overview tab otherwise Google will apply daily limits and the API you have created won’t work. Please see the last screenshot below for more details.

Note: You can read more about limits and charges here.

I see this warning message “This key is unrestricted”, do I have to restrict API key?

The API key restriction is not required for the software to work, but to prevent unauthorised use and quota theft you might want to restrict your key usage.

In order to do it you will have to set up two separate API keys and configure “Key restrictions” section as follows:

Browser key
1. In API name field enter “Browser key”.
2. From “Key restrictions -> Application restrictions” (displayed below name field) section select option “HTTP referrers (websites)”.
3. In the section “Accept requests from these HTTP referrers (websites)” enter the URL (http:// and https://) where the booking software is installed e.g. “http://example.com/*” and “https://example.com/*”. Each URL should be entered in new row.
Please note that you must replace “example.com” with the correct domain or sub-domain name to make it working (you can get  this name from the URL that you use to login to booking admin panel).
In booking software version 3.10.2 or higher you can find this information in Admin -> Settings -> Google tab, just click “Key restrictions” button for correct settings. This button is located above Google API fields.
4. Save changes.

Server key
1. In API name field enter “Server key”.
2. From “Key restrictions -> Application restrictions” (displayed below name field) section select option “IP addresses (web servers, cron jobs, etc.)”.
3. In the section “Accept requests from these server IP addresses” enter the Server IP where the booking software is installed e.g. “127.0.0.1”.
Please note that you must replace “127.0.0.1” with the correct Server IP name to make it working.
You can check your domain or sub-domain IP address here, just enter its name in the box and click “Lookup” button.
In booking software version 3.10.2 or higher you can find this information in Admin -> Settings -> Google tab, just click “Key restrictions” button for correct settings. This button is located above Google API fields.
4. Save changes.

Note: If the key restriction are set incorrectly the booking system will be unable to give any location suggestions or calculate journey price.
In case you have any problems please disable API key restriction to see if the system will work without it.
If it does then it means the restriction hasn’t been set correctly.

Once you have created and restricted your API keys you must update them in Admin -> Settings -> Google -> API keys section setting like this:

Maps JavaScript API = Enter Browser key here
Maps Embed API = Enter Browser key here

Directions API = Enter your Server key here
Places API = Enter your Server key here
Geocoding API = Enter your Server key here

If done correctly your API key should be restricted now.