Appearance

Thumbnails ​

Consent Overlays automatically fetch and show thumbnails of your map and video content (i.e. Google Maps, OpenStreetMap, Vimeo and YouTube).

To enable thumbnail generation, you need to insert your API key for the corresponding service.

Secure thumbnail generation

Thumbnail generation is secured by hashes to block unauthorized requests to your server and APIs.

Maps Static API ​

This API is used to generate static images for your Google Maps map. Once you have entered your Maps Static API key, our extension fetches thumbnails based on your center coordinates and zoom settings. To enable thumbnail generation:

  1. Go to your Google Cloud Console.
  2. Select your project or create a new project.
  3. Go to APIs & Services → Enabled APIs & services.
  4. Click on Enable APIs and services.
  5. Search for Maps Static API, click on it and enable it.
  6. Go to APIs & Services → Credentials.
  7. Click on Create Credentials → API key and copy the generated API Key.
  8. Log in to your website backend.
  9. Go to YOOtheme Pro → Corporate Tools → Consent Tools → Consent Overlay → Google Maps.
  10. Go to Advanced tab.
  11. Enter your Maps Static API key.

Your website should now generate thumbnails and display theme underneath your Consent Overlays for Google Maps.

Define key restrictions

In your Google Cloud Console, you can define key restrictions (such as website, IP address or API restrictions). This is a powerful tool to prevent unauthorized requests to your API.

Limit API requests

If you encounter too many or fraudulent requests, activate the "Limit API requests" checkbox in the Advanced settings. This will instruct our extension to fetch exactly 1 image with maximum dimensions. Downside is that the copyright text may not be visible any more depending on the HTML element's dimensions on your website.

Geoapify ​

This API is used to generate static images for your OpenStreetMap map. Once you have entered your API key, our extension fetches thumbnails based on your center coordinates and zoom settings.

Speed up thumbnail delivery

Unlike video thumbnails, map thumbnails are generated dynamically according to the map dimensions. Since we cannot control the time it takes external APIs to generate thumbnails, there may be a noticeable delay before thumbnails are displayed. To circumvent this delay, you can also hit the "Limit API requests" checkbox to fetch exactly 1 image with maximum dimensions.

Vimeo oEmbed ​

This API is used to request the link for the thumbnail with highest resolution. You don't have to enter an API key. Thumbnails are fetched based on the Vimeo video ID.

YouTube Data API ​

This API is used to request the link for the thumbnail with highest resolution. Once you have entered your API key, our extension fetches thumbnails based on the YouTube video ID.