Google Keys (Captcha, Maps)

The Rayos Platform uses Google reCaptcha and Google Maps to integrate with several site features. You will need to create a Google reCaptcha and Google Maps API key for your site.

Before creating keys, make sure you are signed into the Google account you want to control the keys.

Important: The account should not be a personal Google account.

The account should:

  • Be a Google account tied to your site.
  • Be the same account for all keys.

reCaptcha

We will set up reCaptcha on any form or submission interface website visitors interact with in order to protect you against spam and other types of automated abuse.

In order for the reCaptcha to work, we will need you to set up a Google reCaptcha key:

  1.  Go to Google’s reCAPTCHA Developer Documentation
  2. Enter the label “reCAPTCHA for yourdomain.com” (use your domain)
  3. Select the reCaptcha type “reCAPTCHA v2 > Checkbox”
  4. Enter the following domains:
    • Your site’s domain
    • pantheonsite.io
    • gtxcel.net
  5. Accept the terms and hit Submit

Once you hit submit you will be given a site key and a secret key.  Send both to your project coordinator.

Note: The domains should not include the http://www information. The pantheonsite.io and gtxcel.net domains will assure that reCaptcha works on all of the Rayos Platform testing and development environments.

Google Maps API Keys

Creating New API Keys

For Google maps to work correctly across your site, you’ll need to:

  • Create a billing account
  • Create a project
  • Share your project with the Rayos Team

Before you begin, make sure you’re signed in to the same Google account that controls your reCaptcha key.

Set Up A Billing Account

  1. Go to https://console.cloud.google.com/billing

If you have an active billing account:

  1. If you have a billing account active, click on the account name. (Note: If you don’t see an account but believe you have one set up in your Google Account, and see a Select An Organization dropdown at the top of the screen, change your organization in the dropdown.)
  2. Check both the Billing Account Overview and Payment Overview tabs; make changes as needed. Once you are satisfied with the settings, proceed to the Create An API Key section.
  3. If you do not want to use this account, click the Billing icon in the upper left to return to the main billing section, then follow the below directions for creating a new billing account.

If you don’t have an active billing account, or want to set up a new account:

  1. In the My Billing Accounts area, click Create Account
  2. Follow Google’s prompts

Once your billing account is configured, proceed to the Create A Project section.

Create A Project

  1. In the same tab, go to https://cloud.google.com/maps-platform/
  2. Click Get Started
  3. Select the Places product. Click Continue.
  4. If you are given options, pick +Create a new project. Name the project “[Your site name] Google Maps,” replacing [Your site name] with your site’s actual name. If you’re asked to agree to the terms of service, check Yes. Press Next.
  5. You’ll see a “Set the billing account…” popup. Select the billing account you’d like to use. Click Set Account.
  6. You’ll see an Enable Your APIs popup. Click Next.
  7. You’ll see another popup with an API key. Click Done.

Once you’ve created a project, proceed to the Share With Rayos Team section.

Share With Rayos Team

These steps will allow the Rayos Team to configure your keys properly so they will work with all the integrations on your site. The Rayos Team will be able to create and modify keys, but won’t have access to your billing account.

    1. In the same tab, go to this link: https://console.cloud.google.com/iam-admin
    2. Near the top of the screen, click +Add
    3. In the New Members field, put rayosplatform@gmail.com
    4. In the Select A Role dropdown, pick Project > Editor.
    5. Click Save.

Frequently Asked Questions

 How do I find my API keys?

While signed in to the Google account used to create the key, go to https://console.developers.google.com/apis/dashboard. Make sure the project you created for your site’s Google Maps API key is listed at the top of the screen; if it isn’t, click the dropdown arrow next to the project name to select the right project.

Hover over the key icon in the left rail. Click Credentials. All of the API keys you created for this project will be listed on this page.

How much should I expect to pay?

Google is offering $200 of free monthly usage per billing account. This equates to 28,000 API loads per month. Overages are $7.00 per every 1,000 API loads beyond the 28,000.

Most Rayos Platform map users get between 100 and 3,000 map loads per month. If you only have one website project in your Google Cloud Platform, you should not expect to pay overages.

Additionally, as part of the standard key setup, the Rayos Team will change the page load quotas on the keys to limit the number of API loads per day. This will help protect against overages.

To update the quotas, use the following steps.

  1. In the Dashboard section, open the API. (Rayos sites use the Geocoding and Maps APIs.)
  2. Choose the Quotas tab
  3. Change Map loads per day
  4. Change Map loads per 100 seconds
  5. Change Map loads per 100 seconds per user

Note: The Rayos Team’s standard quota setup is based on the assumption you have one project in the Google APIs platform. If you later set up multiple projects, we recommend lowering the quotas to protect against overages.