We have provided condensed instructions here to make implementation of Google Maps easy with Bullseye. You will need to have a Google account (gmail account) before you create your Developer's account which is necessary to obtain the Key. These instructions assume you do not have a developer's account created yet, and that you are using a standard Bullseye interface. Google also provides instructions on how to use their API Key: https://developers.google.com/maps/documentation/embed/get-api-key#key-restrictions
Make sure that you also enter your billing information into your Google account. You will also need to upgrade the account from a trial account to a paid account. You may upgrade in your Google Cloud Platform Console by clicking on the Upgrade button on the top of the page. If you don't see upgrade, click on Free trial status and Upgrade will appear on the upper right.
To use your own Google Maps API key with Bullseye, you must create the key through a Google developers account and enable two specific APIs:
- Google Maps Geocoding API
1. Log in to the Google APIs manager
Log in with a valid Google account
(You may be asked to accept updated terms of service).
2. Create a project
Select "Create project" as per the screenshot:
You will see an option to select or create as per the image below, select "create".
You will see a page that has your project name and organization. You may also see a "location" heading.
Project Name: You may keep the default name or change as needed.
Organization: This will be based upon the domain you set up with your Google account.
Location: If your organization has a folder set up already, you can use the default folder that is supplied in the field. The location may not be included.
After you select "create" you may be taken directly to the API & Services page which lets you select the credentials link, or you may be taken to the dashboard. The dashboard looks like this:
Under "Getting Started" select "Enable APIs and get credentials like keys.
You will be taken to the aforementioned API & Services page:
Select "credentials" on the left hand side and next to "create credentials" in the middle of the page (circled above) and select the API key option from the drop down menu.
You will see the following:
Select "Restrict Key." You'll see the following:
For Now, Select "Save." You can add restrictions later on if necessary (see the end of this article). After you select "Save" You'll see the screen below:
We recommend that you copy the key with your mouse, and paste it somewhere. You will need to paste this key into the Bullseye admin later. After you have done that, select "Dashboard" as in the image above. You'll see the following:
Select "View All" on the right.
You'll see the following:
Select "Enable." You should see the following:
Now we need to enable the Geocoding API. This API allows you to assign lat/long coordinates to your locations so they can be used on the Google Map. Select "APIs" as in the image above. You will see the following:
Select Geocoding API which is under Unused APIs (make sure you don't select Geolocation API by mistake). You will see the following:
4. Paste the Google API Key into your Bullseye Account
Login to Bullseye at https://app.bullseyelocations.com/Admin/login.aspx
Go to Settings>Set Up>Mapping on the top right. You will see the following:
1. Select the Google checkbox on the top left, beneath "Use Your Own Mapping."
3. Check the "Same as Mapping API Key" checkbox.*
4. Select "Default Mapping Service."
5. Select Save.
*Notes on Setting Restrictions and Using the Geocoding API
You can paste subdomain into your Google Developers account.
If you are using a custom locator, allow requests from the domain of the custom locator, or if your url has a subdomain, you'll need to allow requests from the entire url.
We also suggest entering "app.bullseyelocations.com" to the search api key in order to view the maps inside the admin, when you view the details of each location, or need to make edits.
Google allows the user to set which APIs a key can be used by, and to restrict access on either a URL/domain or an IP Address basis. Please note, the restriction is either/or - you cannot restrict a key on both a URL and an IP Address. A further limitation by Google is that any key restricted by a URL cannot be used with their Geocoding API. Only IP Addresses can be restricted when using the Geocoding Key.
If you will be uploading locations in a csv or xml file through your Bullseye account, or will be adding locations manually in your Bullseye account, and wish to use restrictions, you will need to add in the IP Address (22.214.171.124).
If you will be sending XML files via FTP and wish to restrict the Geocoding API key, and are going to use restrictions, you will need to add the IP Address of our resource server (126.96.36.199) to that key's restriction list.