Перейти к основному содержимому

Troubleshooting

This guide covers the most common issues merchants encounter with Store Locator Map: SE and how to resolve them.

Map Not Loading​

Symptoms: The store locator section appears on the page, but the map area is blank, gray, or displays a "For development purposes only" watermark.

Cause: The Google Maps API key is missing, invalid, or the required APIs are not enabled.

Solution:

  1. Open the app and go to Settings > Google Maps.
  2. Verify that an API key is entered. If the field is empty, add your key.
  3. Log in to the Google Cloud Console and confirm the following APIs are enabled for your project:
    • Maps JavaScript API
    • Geocoding API
  4. Under APIs & Services > Credentials, confirm the API key does not have overly restrictive application or API restrictions that block the required services.
  5. Check that billing is enabled on your Google Cloud project. Google requires an active billing account even when usage falls within the free tier.
  6. Save your settings in the app and reload your storefront to test.

If the map still does not load, open your browser's developer console (F12 or Cmd+Option+I) and look for error messages from Google Maps. Common errors include ApiNotActivatedMapError and InvalidKeyMapError.

Locations Not Showing on the Map​

Symptoms: The map loads correctly, but no markers appear -- even though locations have been added in the app.

Cause: Locations may have failed geocoding, or they may be set to inactive.

Solution:

  1. Go to Locations in the app sidebar.
  2. Check whether any locations display a warning icon indicating a geocoding failure.
  3. For flagged locations, verify that the address is complete and correctly formatted, then click Re-geocode.
  4. Confirm that the locations are marked as Active. Inactive locations are hidden from the storefront map.
  5. If you recently imported locations via CSV, allow a few minutes for bulk geocoding to complete. The app processes addresses asynchronously.

Search Not Working​

Symptoms: Customers type a search term and either nothing happens, or the map does not re-center to the expected area.

Cause: The Places API or Geocoding API may not be enabled in your Google Cloud project.

Solution:

  1. In the Google Cloud Console, navigate to APIs & Services > Library.
  2. Search for Places API and confirm it is enabled. This is required for autocomplete suggestions.
  3. Search for Geocoding API and confirm it is enabled. This is required for resolving search terms to coordinates.
  4. If you recently enabled these APIs, wait a few minutes for the changes to propagate, then test again.
  5. In the app, go to Settings > Search and ensure autocomplete is toggled on.

Widget Not Appearing on the Storefront​

Symptoms: The store locator does not appear on the page where you expect it, even though you have configured it in the theme editor.

Cause: The app block may not be saved, the app may not be embedded, or there may be a theme compatibility issue.

Solution:

  1. In your Shopify admin, go to Online Store > Themes > Customize.
  2. Navigate to the page template where the store locator should appear.
  3. Verify that the Store Locator Map: SE app block (or section) is present in the template. If not, add it.
  4. Click Save in the theme editor.
  5. If you are using a non-Online Store 2.0 theme, you must embed the widget manually. Go to Settings > Embed Code in the app, copy the HTML snippet, and paste it into your page's Liquid template.
  6. Confirm the app is enabled in Settings > App embeds within the theme editor. Some themes require app embeds to be toggled on.

Slow Map with Many Locations​

Symptoms: The map takes a long time to load, or the browser becomes sluggish when rendering a large number of markers (typically 200+).

Cause: Rendering hundreds of individual markers simultaneously can overwhelm the browser.

Solution:

  1. Enable marker clustering in Settings > Appearance > Clustering. Clustering groups nearby markers into a single cluster icon and expands them as the customer zooms in.
  2. Set a reasonable default zoom level so the initial view does not attempt to display every marker at once.
  3. Enable viewport-based loading in Settings > Performance. This option loads only the markers visible within the current map viewport, reducing the number of rendered elements.
  4. If you have more than 1,000 locations, consider using tag-based filtering to allow customers to narrow results before viewing the map.

Symptoms: Clicking "Get Directions" does nothing, or the link opens Google Maps without a destination.

Cause: The location may be missing coordinate data, or the directions feature may be misconfigured.

Solution:

  1. Edit the affected location and verify that it has valid latitude and longitude coordinates.
  2. If coordinates are missing, click Re-geocode to resolve them from the address.
  3. In Settings > Directions, confirm that the directions mode is set correctly (external for a new-tab link, or inline if the Directions API is enabled).

Still Need Help?​

If the steps above do not resolve your issue, contact the Scrollengine support team. See Contact Support for available channels.