Menu

  1. Blog
  2. Agencja WordPress – Software House
  3. Wsparcie techniczne
  4. Mapa Google nie działa na stronie WordPress — Google Cloud Console, API key i billing
17 sierpnia 2026

Mapa Google nie działa na stronie WordPress — Google Cloud Console, API key i billing

W treści wpisu znajdziesz:

  1. Mapa Google nie działa na stronie – szybka odpowiedź
  2. Kiedy mapa Google wymaga Google Cloud Console, a kiedy wystarczy zwykłe osadzenie?
  3. Czym jest dynamiczna mapa Google na stronie WordPress?
  4. Dlaczego mapa Google przestała działać?
  5. Co oznacza komunikat „This page can’t load Google Maps correctly”?
  6. Google Cloud Console – dlaczego jest potrzebne do mapy?
  7. Czy do mapy Google trzeba podpinać kartę płatniczą?
  8. Czy Google Maps API jest płatne?
  9. 200 USD miesięcznie, 300 USD na start i bezpłatne progi użycia – o co chodzi?
  10. Co trzeba skonfigurować w Google Cloud Console?
  11. Klucz API Google Maps – czym jest i dlaczego jest ważny?
  12. Dlaczego nie wolno zostawiać klucza API bez ograniczeń?
  13. Najczęstsze błędy konfiguracji Google Maps API
  14. Mapa Google w WordPress – gdzie wpisać API key?
  15. Mapa Google a WordPress, wtyczki i page buildery
  16. Czy zwykła mapa iframe będzie lepsza?
  17. Mapa Google a cookies, RODO i wydajność strony
  18. Co przygotować, jeśli chcesz zlecić naprawę mapy Google?
  19. Jak Webtom.pl pomaga naprawić mapę Google na stronie WordPress?
  20. Kiedy warto zlecić konfigurację Google Maps API?
  21. Podsumowanie – mapa Google na stronie to nie tylko wklejony kod
  22. FAQ – mapa Google nie działa na stronie WordPress

Mapa Google na stronie internetowej może przestać działać z wielu powodów. Czasami problem pojawia się po aktualizacji WordPressa, zmianie wtyczki, migracji strony albo przejściu na nową domenę. W innych przypadkach mapa działała przez lata, ale nagle wyświetla komunikat o błędzie, szare tło, znak wodny „for development purposes only” albo w ogóle nie ładuje markerów.

W przypadku prostych map osadzonych jako iframe problem zwykle jest mniej skomplikowany. Inaczej wygląda sytuacja, gdy strona korzysta z dynamicznej mapy Google, czyli rozwiązania opartego o Google Maps API, klucz API, Google Cloud Console i konto rozliczeniowe. Wtedy mapa nie jest już tylko fragmentem osadzonego kodu, ale zewnętrzną usługą, którą trzeba poprawnie skonfigurować, zabezpieczyć i monitorować.

Ten artykuł wyjaśnia, dlaczego mapa Google może nie działać na stronie WordPress, kiedy konieczne jest konto w Google Cloud Console, po co potrzebny jest klucz API, dlaczego Google wymaga podpięcia billing account, jakie limity darmowego użycia obowiązują dla dynamicznych map i co sprawdzić, zanim uznasz, że „strona się zepsuła”.

Mapa Google nie działa na stronie – szybka odpowiedź

Jeżeli mapa Google nie działa na stronie WordPress, najczęściej problem dotyczy konfiguracji Google Maps API. Przy dynamicznych mapach trzeba sprawdzić przede wszystkim klucz API, projekt w Google Cloud Console, aktywne rozliczenia, włączone odpowiednie API, ograniczenia domeny, limity użycia, konfigurację wtyczki WordPress, cache, minifikację JavaScript oraz błędy w konsoli przeglądarki.

Najczęstsze przyczyny problemów z mapą Google na stronie to:

  • brak klucza API Google Maps,
  • nieprawidłowy lub usunięty klucz API,
  • brak aktywnego konta rozliczeniowego w Google Cloud,
  • niepodpięta, wygasła albo odrzucona karta płatnicza,
  • niewłączone Maps JavaScript API,
  • źle ustawione ograniczenia domeny,
  • zmiana domeny, subdomeny albo środowiska stagingowego,
  • przekroczone limity użycia,
  • konflikt wtyczki WordPress,
  • blokada skryptów przez cache lub optymalizację JavaScript,
  • błędy w kodzie strony,
  • blokada mapy przez mechanizm cookies lub consent.

W praktyce naprawa mapy Google polega najpierw na ustaleniu, jak mapa została wdrożona: jako zwykłe osadzenie iframe, przez wtyczkę WordPress, przez motyw, przez ACF Google Map, przez Elementor, przez własny kod albo przez dedykowany moduł korzystający z Google Maps Platform.

Kiedy mapa Google wymaga Google Cloud Console, a kiedy wystarczy zwykłe osadzenie?

Mapę Google na stronie internetowej można dodać na kilka sposobów. Nie każdy z nich wymaga konfiguracji Google Cloud Console, klucza API i konta rozliczeniowego.

Jeżeli na stronie ma pojawić się prosta mapa z jedną lokalizacją firmy, często wystarczy zwykłe osadzenie mapy z Google Maps. W takim wariancie użytkownik widzi lokalizację, może kliknąć mapę i przejść do wskazówek dojazdu, ale sama mapa nie obsługuje zaawansowanej logiki po stronie serwisu.

Inaczej wygląda sytuacja, gdy strona korzysta z mapy dynamicznej. Dotyczy to m.in. map z wieloma markerami, wyszukiwarką lokalizacji, filtrowaniem punktów, mapą dystrybutorów, geokodowaniem adresów, autouzupełnianiem, własnym wyglądem mapy albo integracją z bazą danych w WordPressie.

W takich przypadkach najczęściej potrzebne są:

  • projekt w Google Cloud Console,
  • aktywne konto rozliczeniowe,
  • podpięta karta lub inna metoda płatności,
  • włączone odpowiednie usługi Google Maps Platform,
  • klucz API,
  • ograniczenia bezpieczeństwa dla klucza,
  • poprawna konfiguracja w WordPressie.

Dlatego przed naprawą mapy trzeba najpierw ustalić, jak została wdrożona. Jeśli jest to proste osadzenie, problem może dotyczyć samego kodu lub sposobu wyświetlania mapy. Jeśli jest to mapa dynamiczna, trzeba sprawdzić również Google Cloud Console, API key, billing, limity użycia i konfigurację domeny.

Mapa Google nie dziala na stronie WordPress - Google Cloud Console, API key i billing
Mapa Google nie dziala na stronie WordPress - Google Cloud Console, API key i billing

Czym jest dynamiczna mapa Google na stronie WordPress?

Dynamiczna mapa Google to mapa, która nie jest tylko statycznym osadzeniem lokalizacji. To element strony korzystający z usług Google Maps Platform, najczęściej przez Maps JavaScript API lub inne powiązane usługi Google.

Dynamiczna mapa może obsługiwać m.in.:

  • wiele punktów na mapie,
  • własne markery,
  • mapę dystrybutorów,
  • mapę oddziałów,
  • wyszukiwarkę najbliższej lokalizacji,
  • filtrowanie punktów po typie, regionie lub usłudze,
  • geokodowanie adresów,
  • autouzupełnianie adresu,
  • wyznaczanie trasy,
  • niestandardowy wygląd mapy,
  • integrację z bazą lokalizacji,
  • pobieranie danych z WordPressa, API lub zewnętrznego systemu.

W WordPressie taka mapa może być wdrożona przez wtyczkę, motyw, page builder, ACF, własny moduł albo dedykowany kod. Dlatego nie ma jednego miejsca, w którym zawsze wpisuje się klucz API. To zależy od sposobu wdrożenia mapy.

Dlaczego mapa Google przestała działać?

Mapa Google może przestać działać nawet wtedy, gdy sama strona WordPress działa poprawnie. Wynika to z tego, że mapa dynamiczna jest zależna od zewnętrznej usługi Google, konfiguracji projektu w Google Cloud Console, rozliczeń, klucza API, domeny i kodu, który ładuje mapę na stronie.

Najczęstsze przyczyny awarii mapy Google to:

  • brak klucza API,
  • błędnie wpisany klucz API,
  • klucz API został usunięty,
  • klucz API został ograniczony do innej domeny,
  • domena strony została zmieniona,
  • strona została przeniesiona ze stagingu na produkcję,
  • billing w Google Cloud nie jest aktywny,
  • metoda płatności wygasła albo została odrzucona,
    konto rozliczeniowe zostało odłączone od projektu,
  • w projekcie nie włączono Maps JavaScript API,
  • mapa korzysta z dodatkowej usługi, która nie została aktywowana,
  • limit użycia został przekroczony,
  • wtyczka WordPress przestała być kompatybilna,
  • optymalizacja JavaScript blokuje skrypt Google Maps,
  • włączony cache lub minifikacja zmieniły kolejność ładowania skryptów,
  • mechanizm zgód cookies blokuje zewnętrzny skrypt,
  • po aktualizacji zmienił się sposób działania motywu lub wtyczki.

Właśnie dlatego przy diagnozie nie wystarczy sprawdzić, czy WordPress działa. Trzeba ustalić, czy strona poprawnie łączy się z Google Maps Platform i czy Google akceptuje żądania wysyłane z danej domeny.

Co oznacza komunikat „This page can’t load Google Maps correctly”?

Komunikat „This page can’t load Google Maps correctly” oznacza, że mapa Google nie może zostać poprawnie załadowana na stronie. W praktyce często jest to związane z problemem klucza API, billingiem, ograniczeniami domeny, niewłączonym API albo błędem konfiguracji.

Czasami na mapie pojawia się też znak wodny: for development purposes only.

Taki komunikat zwykle sugeruje problem z konfiguracją Google Maps Platform: kluczem API, rozliczeniami, włączonym API, ograniczeniami domeny albo sposobem ładowania mapy na stronie.

Właściwej przyczyny nie należy zgadywać. Trzeba sprawdzić konsolę przeglądarki, zakładkę Network, konfigurację wtyczki WordPress i ustawienia projektu w Google Cloud Console. Komunikaty błędów Google Maps JavaScript API często wskazują konkretny problem, np. brak klucza API, niewłączone API, przekroczony limit albo nieautoryzowaną domenę.

Jeżeli mapa przestała działać na stronie firmowej i nie masz pewności, czy problem wynika z WordPressa, wtyczki, Google Cloud Console czy billing account, warto zlecić techniczną diagnostykę. W takich sytuacjach pomocne może być wsparcie techniczne WordPress, które obejmuje analizę konfiguracji strony, błędów JavaScript, wtyczek, cache i zewnętrznych usług podłączonych do serwisu.

Mapa Google wyświetla błąd na stronie?

Sprawdzimy, czy problem wynika z konfiguracji Google Cloud Console, klucza API, billing account, ograniczeń domeny, wtyczki WordPress, cache czy błędów JavaScript. Zweryfikujemy przyczynę i wskażemy, co trzeba zrobić, żeby mapa znów działała poprawnie.

 

Zleć diagnozę mapy Google Zleć diagnozę mapy Google

Google Cloud Console – dlaczego jest potrzebne do mapy?

Google Cloud Console to panel, w którym zarządza się projektem Google Cloud, usługami Google Maps Platform, kluczami API, rozliczeniami, ograniczeniami i limitami użycia.

Jeżeli strona WordPress korzysta z dynamicznej mapy Google, samo wklejenie mapy w panelu strony może nie wystarczyć. Trzeba przygotować konfigurację po stronie Google.

Najczęściej obejmuje to:

  • utworzenie projektu w Google Cloud,
  • włączenie odpowiednich usług Google Maps Platform,
  • aktywowanie konta rozliczeniowego,
    skonfigurowanie metody płatności, np. karty,
  • wygenerowanie klucza API,
  • ograniczenie klucza do konkretnej domeny,
  • ograniczenie klucza do konkretnych usług,
  • wpisanie klucza API w WordPressie, wtyczce albo kodzie,
  • przetestowanie działania mapy,
  • ustawienie limitów i alertów kosztowych.

Dla właściciela strony może to wyglądać jak dodatkowa formalność, ale w praktyce jest to element poprawnego działania mapy dynamicznej. Google Maps Platform jest usługą rozliczaną według użycia dla poszczególnych SKU, dlatego żądania powinny być przypisane do konkretnego projektu, klucza API i konta rozliczeniowego.

Czy do mapy Google trzeba podpinać kartę płatniczą?

To zależy od sposobu wdrożenia mapy. Przy prostej mapie osadzonej jako iframe konfiguracja Google Cloud Console zwykle nie jest potrzebna. Inaczej wygląda sytuacja, gdy strona korzysta z dynamicznej mapy Google przez Google Maps Platform, np. przez Maps JavaScript API.

W takim przypadku potrzebne jest aktywne konto rozliczeniowe w Google Cloud oraz poprawnie skonfigurowana metoda płatności, np. karta. Nie oznacza to automatycznie wysokich kosztów, ale jest elementem wymaganym do prawidłowego działania wielu usług Google Maps Platform.

Google Maps Platform działa w modelu płatności według użycia. Dla wielu małych stron firmowych liczba załadowań mapy może mieścić się w bezpłatnych progach użycia, ale rozliczenia i tak muszą być poprawnie skonfigurowane, jeśli dana mapa korzysta z usług wymagających konta rozliczeniowego.

Ważne jest również to, aby po włączeniu rozliczeń ustawić ograniczenia klucza API, limity i alerty kosztowe. Dzięki temu można ograniczyć ryzyko nieautoryzowanego wykorzystania klucza oraz nieprzewidzianych kosztów.

Czy Google Maps API jest płatne?

Google Maps Platform działa w modelu płatności według wykorzystania. Oznacza to, że użycie poszczególnych usług jest liczone według konkretnych SKU, np. Dynamic Maps, Geocoding, Places albo innych usług Google Maps Platform.

Nie wszystkie sposoby osadzenia mapy mają jednak takie same zasady. Proste użycie Maps Embed API jest według Google dostępne bez opłat i bez limitów użycia. Inaczej wygląda Dynamic Maps, czyli dynamiczna mapa ładowana przez Maps JavaScript API – tutaj Google pokazuje miesięczny próg bezpłatnego użycia, a po jego przekroczeniu naliczane są opłaty według cennika.

W rozliczeniach Google Maps można spotkać kilka różnych informacji: bezpłatne progi użycia dla konkretnych SKU, 300 USD środków powitalnych w Google Cloud dla nowych użytkowników oraz wzmianki o 200 USD miesięcznego kredytu dla kwalifikujących się kont. Dlatego w artykule dla właścicieli stron najlepiej nie upraszczać tego do jednego zdania „Google Maps jest darmowe” albo „Google daje zawsze 200 USD miesięcznie”.

Dla Dynamic Maps w kategorii Essentials oficjalny cennik pokazuje 10.000 bezpłatnych zdarzeń miesięcznie. Po przekroczeniu tego progu dalsze użycie jest rozliczane zgodnie z aktualnym cennikiem Google.

W praktyce oznacza to, że mała strona firmowa może nie generować kosztów, jeśli użycie dynamicznej mapy mieści się w bezpłatnym limicie. Nie należy jednak zakładać, że mapa zawsze będzie darmowa. Koszt zależy od ruchu na stronie, sposobu wdrożenia mapy, liczby wyświetleń i dodatkowych usług, takich jak Places, Autocomplete czy Geocoding.

Czy Google Maps API jest platne?
Czy Google Maps API jest platne?

200 USD miesięcznie, 300 USD na start i bezpłatne progi użycia – o co chodzi?

W artykułach, poradnikach i rozmowach z wykonawcami można spotkać różne informacje o rozliczeniach Google Maps Platform: 200 USD miesięcznego kredytu, 300 USD środków powitalnych oraz bezpłatne miesięczne limity użycia. To nie są dokładnie te same pojęcia.

300 USD dotyczy bezpłatnego okresu próbnego Google Cloud dla nowych użytkowników. Google wskazuje, że trial kończy się po upływie okresu próbnego albo po wykorzystaniu środków, zależnie od tego, co nastąpi wcześniej. Jeśli pierwsze konto rozliczeniowe jest używane z projektami Google Maps Platform, środki trial mogą być stosowane razem z bezpłatnymi progami użycia Google Maps Platform.

200 USD miesięcznie to informacja, którą wiele osób kojarzy ze starszym modelem rozliczeń Google Maps Platform. Google w dokumentacji zmian z 1 marca 2025 r. opisuje przejście z miesięcznych środków 200 USD na miesięczne progi bezpłatnego użycia dla poszczególnych SKU usług podstawowych. Jednocześnie w dokumentacji startowej Google nadal pojawia się wzmianka o 200 USD miesięcznego kredytu dla kwalifikujących się kont, dlatego najbezpieczniej nie przedstawiać tej kwoty jako uniwersalnej zasady dla każdej mapy i każdej strony.

Najważniejsze dla właściciela strony jest to, że koszt zależy od sposobu wdrożenia mapy i rodzaju użytych usług. Inaczej traktowane jest proste osadzenie mapy, inaczej Maps Embed API, a inaczej Dynamic Maps, Geocoding, Places czy Autocomplete.

W praktyce warto zapamiętać trzy rzeczy:

  • dynamiczna mapa Google zwykle wymaga projektu w Google Cloud i aktywnego konta rozliczeniowego,
  • część użycia może mieścić się w bezpłatnym miesięcznym progu danego SKU,
  • konfigurując mapę, trzeba sprawdzić aktualny cennik Google, ograniczyć klucz API oraz ustawić limity i alerty kosztowe.

Dlatego nie warto opierać decyzji na uproszczeniu „Google Maps zawsze jest darmowe” albo „Google zawsze daje 200 USD miesięcznie”. Bezpieczniej jest sprawdzić, z jakich usług korzysta konkretna mapa i jak są one rozliczane w aktualnym cenniku Google Maps Platform.

Co trzeba skonfigurować w Google Cloud Console?

Aby dynamiczna mapa Google działała poprawnie na stronie WordPress, zwykle trzeba przejść kilka kroków konfiguracyjnych.

1. Utworzyć lub wybrać projekt Google Cloud

Klucz API i rozliczenia są przypisane do konkretnego projektu. Jeśli firma ma już projekt Google Cloud, można wykorzystać istniejący projekt. Jeśli nie, trzeba utworzyć nowy.

Ważne jest, aby projekt był założony na koncie, do którego firma ma trwały dostęp. Nie powinien być zakładany wyłącznie na prywatnym koncie przypadkowej osoby, freelancera lub byłego pracownika.

2. Włączyć billing

Dla Google Maps Platform potrzebne jest aktywne konto rozliczeniowe. Bez billing account mapa dynamiczna może nie działać lub wyświetlać komunikaty błędów.

Na tym etapie trzeba skonfigurować metodę płatności obsługiwaną przez Google Cloud, np. kartę. W praktyce najważniejsze jest to, aby projekt miał aktywne konto rozliczeniowe i nie był zablokowany z powodu problemu z płatnościami.

3. Włączyć odpowiednie API

Najczęściej przy dynamicznej mapie na stronie potrzebne jest Maps JavaScript API. W zależności od funkcji mogą być potrzebne także inne usługi, np. Places API, Geocoding API albo Directions API.

To ważne, ponieważ sama mapa może się ładować z jednego API, ale wyszukiwarka lokalizacji, autouzupełnianie adresów lub zamiana adresu na współrzędne mogą wymagać dodatkowych usług.

4. Wygenerować klucz API

Klucz API identyfikuje projekt i umożliwia stronie korzystanie z usług Google Maps Platform. Klucz trzeba następnie wpisać w odpowiednim miejscu w WordPressie: w ustawieniach wtyczki, motywu, page buildera, pola ACF albo dedykowanego modułu.

5. Ograniczyć klucz API do domeny

Klucz API nie powinien pozostawać bez ograniczeń. W przypadku mapy ładowanej na stronie internetowej zwykle stosuje się ograniczenia HTTP referrer, czyli ograniczenie użycia klucza do konkretnej domeny.

Dzięki temu ktoś inny nie powinien móc wykorzystać Twojego klucza na swojej stronie.

6. Ograniczyć klucz API do konkretnych usług

Poza ograniczeniem do domeny warto ograniczyć klucz do konkretnych API, które są faktycznie potrzebne. Jeśli strona korzysta wyłącznie z Maps JavaScript API, nie ma sensu zostawiać klucza otwartego na wszystkie usługi Google Maps Platform.

7. Wpisać klucz API w WordPressie

Miejsce wpisania klucza zależy od wdrożenia. Może to być:

  • ustawienie wtyczki mapy,
  • panel motywu,
  • konfiguracja Elementora lub innego page buildera,
  • ustawienie pola ACF Google Map,
  • plik konfiguracyjny motywu,
  • dedykowany kod,
  • panel własnego modułu.

Nie ma jednej uniwersalnej lokalizacji w WordPressie. Dlatego przed zmianą konfiguracji trzeba ustalić, jak mapa została wdrożona.

8. Przetestować działanie mapy

Po konfiguracji trzeba sprawdzić, czy mapa działa na produkcyjnej domenie, w wersji mobilnej, po wyczyszczeniu cache i przy aktywnych mechanizmach cookies lub consent.

Warto sprawdzić również konsolę przeglądarki, ponieważ Google Maps JavaScript API może zwracać błędy lub ostrzeżenia, które nie są widoczne bezpośrednio dla użytkownika.

9. Ustawić limity i alerty kosztowe

Dobra konfiguracja nie kończy się na tym, że mapa zacznie działać. Warto ustawić alerty kosztowe i monitorować użycie w Google Cloud Console. Dzięki temu firma ma kontrolę nad wykorzystaniem usług Google Maps Platform i może szybciej zareagować na nietypowy wzrost liczby żądań. Google udostępnia narzędzia do kontroli kosztów, m.in. limity, alerty i możliwość ograniczania liczby zdarzeń podlegających rozliczeniu.

Potrzebujesz poprawnie skonfigurować Google Maps API?

Możemy pomóc w konfiguracji projektu Google Cloud, konta rozliczeniowego Google Cloud, klucza API, ograniczeń domeny, wymaganych usług Google Maps Platform oraz ustawień po stronie WordPressa. Dzięki temu mapa dynamiczna będzie działać stabilnie, a klucz API będzie lepiej zabezpieczony przed nieautoryzowanym użyciem.

Skonfigurujmy Google Maps API Skonfigurujmy Google Maps API

Klucz API Google Maps – czym jest i dlaczego jest ważny?

Klucz API Google Maps to unikalny ciąg znaków, który pozwala stronie korzystać z usług Google Maps Platform. Dzięki niemu Google wie, z jakiego projektu pochodzi żądanie i do jakiego konta rozliczeniowego należy przypisać użycie mapy.

Brak klucza API albo jego błędna konfiguracja to jedna z najczęstszych przyczyn niedziałającej mapy Google na stronie WordPress.

Problemy z kluczem API mogą obejmować:

  • brak klucza w konfiguracji strony,
  • literówkę w kluczu,
  • usunięty klucz,
  • klucz przypisany do innego projektu,
  • brak aktywnego konta rozliczeniowego w projekcie,
  • niewłączone API,
  • zbyt restrykcyjne ograniczenia domeny,
  • brak domeny produkcyjnej na liście dozwolonych adresów,
  • używanie klucza z innego środowiska, np. stagingu.

Dlatego przy naprawie mapy Google trzeba sprawdzić nie tylko sam WordPress, ale również konfigurację klucza po stronie Google Cloud Console.

Dlaczego nie wolno zostawiać klucza API bez ograniczeń?

Klucz API Google Maps powinien być zabezpieczony. Pozostawienie klucza bez ograniczeń może prowadzić do sytuacji, w której ktoś wykorzysta go poza Twoją stroną. W skrajnym przypadku może to generować niepotrzebne użycie i koszty.

Dobre praktyki konfiguracji klucza API obejmują:

  • ograniczenie klucza do właściwej domeny,
  • dodanie domeny z wersją www i bez www, jeśli obie są używane,
  • uwzględnienie subdomen, jeśli mapa działa np. na stagingu,
  • ograniczenie klucza do konkretnych usług Google Maps,
  • niewklejanie klucza w przypadkowych miejscach,
  • usunięcie starych i nieużywanych kluczy,
  • monitorowanie użycia w Google Cloud Console.

W praktyce samo wygenerowanie klucza API nie wystarczy. Trzeba jeszcze zadbać o jego poprawne ograniczenie, testowanie i kontrolę użycia.

Najczęstsze błędy konfiguracji Google Maps API

Przy mapach dynamicznych bardzo często pojawiają się powtarzalne błędy konfiguracji. Część z nich wynika z niepełnej konfiguracji Google Cloud, a część z samego WordPressa.

Brak aktywnego billing account

Mapa może nie działać, jeśli projekt Google Cloud nie ma aktywnego konta rozliczeniowego. Dotyczy to również sytuacji, w której karta wygasła, płatność została odrzucona albo billing został odłączony od projektu.

Niewłączone Maps JavaScript API

Samo utworzenie projektu i klucza API nie oznacza jeszcze, że mapa zadziała. W projekcie trzeba włączyć odpowiednie API, najczęściej Maps JavaScript API. Jeśli strona korzysta z dodatkowych funkcji, mogą być potrzebne kolejne usługi.

Błędne ograniczenia domeny

Jeżeli klucz API jest ograniczony do konkretnej domeny, a strona działa pod innym adresem, mapa może zostać zablokowana. Problem pojawia się często po migracji strony, zmianie domeny, przejściu z wersji stagingowej na produkcyjną albo zmianie adresu z www na bez www.

Brak domeny stagingowej

Jeżeli testujecie mapę na środowisku stagingowym, a klucz API jest ograniczony tylko do domeny produkcyjnej, mapa może nie działać na stagingu. To nie zawsze jest błąd WordPressa — często to po prostu efekt poprawnie ustawionych ograniczeń klucza.

Przekroczony limit użycia

Jeśli użycie mapy przekroczy dostępny limit lub ustawiony limit dzienny, mapa może przestać działać albo zacząć generować błędy. Warto kontrolować użycie w Google Cloud Console i ustawić alerty.

Konflikt wtyczki lub motywu

Po aktualizacji WordPressa, motywu albo wtyczki mapa może przestać działać, jeśli zmienił się sposób ładowania skryptów, kolejność zależności albo kompatybilność z aktualną wersją Google Maps API.

Cache i minifikacja JavaScript

Wtyczki optymalizacyjne mogą opóźniać, łączyć, minifikować albo przenosić skrypty JavaScript. W niektórych przypadkach może to zaburzyć działanie mapy, szczególnie jeśli kod mapy wymaga konkretnej kolejności ładowania.

Blokada przez cookies lub consent

Mapa Google ładuje zewnętrzne zasoby. W zależności od konfiguracji zgód cookies, CMP lub polityki prywatności może być blokowana do momentu wyrażenia zgody. To nie zawsze oznacza awarię — czasami mapa jest celowo ukrywana przed zgodą użytkownika.

Najczestsze bledy konfiguracji Google Maps API
Najczestsze bledy konfiguracji Google Maps API

Mapa Google w WordPress – gdzie wpisać API key?

Nie ma jednego miejsca w WordPressie, w którym zawsze wpisuje się klucz API Google Maps. To zależy od sposobu wdrożenia mapy.

Klucz API może być wpisany w:

  • ustawieniach wtyczki mapy,
  • ustawieniach motywu,
  • Elementorze lub innym page builderze,
  • konfiguracji ACF Google Map,
  • własnym panelu opcji,
  • pliku konfiguracyjnym motywu,
  • kodzie dedykowanego modułu,
  • skrypcie ładowanym w motywie potomnym.

Dlatego przed zmianami warto ustalić, skąd mapa jest ładowana. Inaczej można wygenerować poprawny klucz API, ale wkleić go w złym miejscu i nadal nie rozwiązać problemu.

W projektach tworzonych profesjonalnie warto dokumentować, gdzie znajduje się konfiguracja usług zewnętrznych: map, formularzy, systemów płatności, narzędzi analitycznych, CRM i API. Ułatwia to późniejszy maintenance WordPress i ogranicza ryzyko problemów po zmianach osób odpowiedzialnych za obsługę serwisu.

Mapa Google a WordPress, wtyczki i page buildery

W WordPressie mapa Google często jest dodawana przez wtyczkę, page builder albo gotowy moduł motywu. To wygodne, ale jednocześnie może utrudniać diagnostykę.

Problem może wynikać nie z Google Cloud, ale z tego, że:

  • wtyczka przestała być aktualizowana,
  • wtyczka wymaga nowego sposobu konfiguracji API key,
  • motyw ładuje starą wersję skryptu,
  • page builder zmienił sposób obsługi mapy,
  • kilka wtyczek próbuje ładować Google Maps jednocześnie,
  • cache zmienia kolejność skryptów,
  • motyw ładuje mapę na każdej podstronie, choć potrzebna jest tylko w kontakcie.

W takich przypadkach trzeba sprawdzić zarówno konfigurację Google Cloud, jak i sposób ładowania mapy po stronie WordPressa.

Czy zwykła mapa iframe będzie lepsza?

Nie zawsze dynamiczna mapa Google jest potrzebna. Jeśli firma chce pokazać jedną lokalizację na podstronie kontaktowej, często wystarczy zwykłe osadzenie mapy albo prostsze rozwiązanie: przycisk prowadzący do Google Maps. W części przypadków można też wykorzystać Maps Embed API, które działa przez iframe i według Google jest dostępne bez opłat oraz bez limitów użycia.

Mapa iframe może być dobrym wyborem, gdy:

  • pokazujesz jedną lokalizację,
  • nie potrzebujesz własnych markerów,
  • nie masz wyszukiwarki oddziałów,
  • nie potrzebujesz geokodowania,
  • nie zależy Ci na niestandardowej logice,
  • chcesz ograniczyć złożoność techniczną.

Dynamiczna mapa ma sens, gdy:

  • pokazujesz wiele lokalizacji,
  • tworzysz mapę dystrybutorów,
  • użytkownik ma wyszukiwać najbliższy punkt,
  • mapa korzysta z danych z WordPressa lub API,
  • potrzebujesz własnych markerów i filtrów,
  • mapa jest częścią większego procesu,
  • lokalizacje mają być zarządzane w panelu CMS.

Warto więc dobrać rozwiązanie do potrzeb. Nie każda strona potrzebuje dynamicznej mapy Google z Google Cloud Console. Ale jeśli taka mapa jest potrzebna, trzeba ją poprawnie skonfigurować.

Mapa Google a cookies, RODO i wydajność strony

Mapa Google jest zewnętrznym elementem ładowanym z usług Google. Może mieć wpływ na prywatność użytkownika, wydajność strony i sposób działania mechanizmu zgód cookies.

W praktyce warto sprawdzić:

  • czy mapa ładuje skrypty zewnętrzne od razu po wejściu na stronę,
  • czy powinna być blokowana do czasu zgody użytkownika,
  • czy jest opisana w polityce prywatności,
  • czy nie spowalnia ładowania najważniejszych podstron,
  • czy nie jest ładowana globalnie na całej stronie,
  • czy można ją ładować dopiero po kliknięciu,
  • czy alternatywnie wystarczy link do Google Maps.

Na stronach firmowych mapa często znajduje się tylko na podstronie kontaktowej. W takim przypadku nie ma sensu ładować skryptów Google Maps globalnie na wszystkich podstronach. To może niepotrzebnie obciążać stronę i wpływać na wydajność.

Jeżeli strona ładuje zewnętrzne skrypty mapy na wielu podstronach, mimo że mapa jest potrzebna tylko w kontakcie, warto sprawdzić sposób ładowania zasobów. W takich przypadkach optymalizacja WordPress może obejmować ograniczenie skryptów Google Maps do konkretnych podstron, ładowanie mapy dopiero po interakcji użytkownika albo zastąpienie dynamicznej mapy prostszym rozwiązaniem tam, gdzie nie jest potrzebna.

Co przygotować, jeśli chcesz zlecić naprawę mapy Google?

Jeśli mapa Google nie działa na stronie WordPress, warto przygotować kilka informacji przed kontaktem z wykonawcą. Przyspieszy to diagnozę i ograniczy liczbę niepotrzebnych ustaleń.

Przydatne informacje:

  • adres strony, na której nie działa mapa,
  • informacja, od kiedy problem występuje,
  • zrzut ekranu błędu,
  • dostęp do WordPressa,
  • informacja, jaka wtyczka lub moduł obsługuje mapę,
  • dostęp do Google Cloud Console albo osoba, która ma taki dostęp,
  • informacja, czy jest podpięty billing,
  • informacja, czy karta płatnicza jest aktywna,
  • informacja, czy ostatnio zmieniano domenę, hosting, motyw lub wtyczki,
  • informacja, czy mapa działa na stagingu lub produkcji,
  • lista ostatnich aktualizacji lub wdrożeń.

Bardzo często największym problemem nie jest sama naprawa mapy, ale brak dostępu do konta Google Cloud, na którym utworzono projekt i klucz API. Dlatego projekty Google Cloud powinny być zakładane na koncie kontrolowanym przez firmę, a nie na prywatnym koncie przypadkowego wykonawcy.

Jak Webtom.pl pomaga naprawić mapę Google na stronie WordPress?

W Webtom.pl analizujemy problem z mapą Google od strony WordPressa, konfiguracji Google Cloud Console i sposobu wdrożenia mapy. Sprawdzamy, czy mapa działa jako iframe, wtyczka, moduł motywu, ACF, page builder czy dedykowany kod korzystający z Google Maps API.

W ramach diagnostyki możemy sprawdzić m.in.:

  • czy mapa korzysta z Google Maps API,
  • czy na stronie jest poprawny klucz API,
  • czy projekt Google Cloud ma aktywny billing,
  • czy karta płatnicza lub metoda rozliczeń działa prawidłowo,
  • czy włączono wymagane API,
  • czy klucz API ma poprawne ograniczenia domeny,
  • czy domena produkcyjna i stagingowa są uwzględnione,
  • czy w konsoli przeglądarki występują błędy Maps JavaScript API,
  • czy wtyczka WordPress jest poprawnie skonfigurowana,
  • czy cache lub minifikacja JavaScript nie blokują mapy,
  • czy mapa nie wpływa negatywnie na wydajność strony,
  • czy konfiguracja jest bezpieczna i możliwa do utrzymania.

Jako agencja WordPresssoftware house możemy nie tylko przywrócić działanie mapy, ale też uporządkować sposób jej wdrożenia. W praktyce może to oznaczać poprawną konfigurację Google Cloud, zabezpieczenie klucza API, zmianę sposobu ładowania mapy, naprawę wtyczki, wdrożenie dedykowego modułu albo uproszczenie rozwiązania, jeśli dynamiczna mapa nie jest potrzebna.

Mapa Google jest dobrym przykładem elementu strony, który wymaga regularnego utrzymania technicznego. Nawet jeśli działała poprawnie w dniu uruchomienia, po czasie może przestać działać przez zmiany w konfiguracji Google Cloud, rozliczenia, aktualizacje WordPressa, zmianę domeny, cache, skrypty zewnętrzne albo brak kontroli nad dostępami. Dlatego maintenance WordPress powinien obejmować również kontrolę zewnętrznych usług, które wpływają na działanie strony.

Mapa Google nadal nie działa?

Sprawdzimy konfigurację Google Cloud Console, klucz API, konto rozliczeniowe, ograniczenia domeny, wtyczkę WordPress, cache i błędy JavaScript. Zweryfikujemy, czy problem leży po stronie Google Maps Platform, WordPressa, sposobu wdrożenia mapy czy konfiguracji zewnętrznych usług.

Zleć diagnozę mapy Google Zleć diagnozę mapy Google

Kiedy warto zlecić konfigurację Google Maps API?

Konfigurację Google Maps API warto zlecić wtedy, gdy mapa ma znaczenie biznesowe i nie jest tylko prostym elementem kontaktowym.

Dotyczy to szczególnie sytuacji, gdy:

  • na stronie działa mapa dystrybutorów,
  • mapa pokazuje wiele lokalizacji,
  • użytkownik może wyszukiwać najbliższy punkt,
  • lokalizacje są zarządzane w WordPressie,
  • mapa korzysta z własnych markerów,
  • mapa pobiera dane z API lub bazy danych,
  • mapa jest połączona z formularzem,
  • mapa działa w kilku wersjach językowych,
  • firma chce kontrolować koszty Google Maps Platform,
  • strona ma być objęta stałym utrzymaniem technicznym lub maintenance WordPress.

W takich przypadkach warto zaplanować mapę jako element techniczny strony, a nie tylko „widget”. Oznacza to dokumentację konfiguracji, kontrolę dostępu do Google Cloud, zabezpieczenie klucza API, monitoring użycia i regularne sprawdzanie działania po aktualizacjach.

Podsumowanie – mapa Google na stronie to nie tylko wklejony kod

Jeżeli mapa Google nie działa na stronie WordPress, problem nie zawsze leży w samej stronie. Przy mapach dynamicznych bardzo często przyczyną jest konfiguracja Google Maps API, Google Cloud Console, billing, klucz API, ograniczenia domeny, limity użycia albo sposób ładowania skryptów.

Dynamiczna mapa Google wymaga poprawnej konfiguracji technicznej. Trzeba mieć projekt Google Cloud, aktywne rozliczenia, właściwe API, klucz API, ograniczenia bezpieczeństwa i poprawne miejsce wpisania klucza w WordPressie. Warto też monitorować użycie i koszty, ponieważ Google Maps Platform działa w modelu płatności według wykorzystania. W przypadku prostszego osadzenia mapy zasady mogą być inne, dlatego przed wdrożeniem lub naprawą trzeba najpierw ustalić, czy strona korzysta ze zwykłego iframe, Maps Embed API czy dynamicznej mapy przez Maps JavaScript API.

Nie każda strona potrzebuje dynamicznej mapy. Przy prostej lokalizacji firmy często wystarczy iframe lub link do Google Maps. Jeśli jednak mapa obsługuje wiele markerów, dystrybutorów, wyszukiwarkę lokalizacji, geokodowanie albo integrację z WordPressem, wtedy Google Cloud Console i Google Maps API są naturalnym elementem wdrożenia.

Dobrze skonfigurowana mapa powinna działać stabilnie, być zabezpieczona, nie generować niekontrolowanych kosztów i nie obciążać strony tam, gdzie nie jest potrzebna. Dlatego konfigurację map dynamicznych warto traktować jako część technicznego utrzymania strony WordPress, a nie jednorazowe zadanie wykonane przy wdrożeniu.

FAQ – mapa Google nie działa na stronie WordPress

Dlaczego mapa Google nie działa na stronie WordPress?

Mapa Google może nie działać z powodu braku klucza API, nieaktywnego billing account, niewłączonego Maps JavaScript API, błędnych ograniczeń domeny, przekroczonego limitu, konfliktu wtyczki, problemu z cache, błędu JavaScript albo blokady skryptów przez mechanizm cookies.

Czy mapa Google na WordPress wymaga klucza API?

Czy trzeba zakładać konto w Google Cloud Console?

Czy do Google Maps API trzeba podpinać kartę płatniczą?

Czy Google Maps API jest darmowe?

Czy Google nadal daje 200 USD miesięcznego kredytu na mapy?

Co oznacza komunikat „This page can’t load Google Maps correctly”?

Co oznacza „for development purposes only” na mapie?

Gdzie wpisać klucz API Google Maps w WordPress?

Czy klucz API Google Maps trzeba ograniczyć do domeny?

Czy mapa Google może spowalniać stronę?

Czy Webtom.pl może naprawić niedziałającą mapę na stronie?

Ten wpis stworzył

Sławomir Woźniak
New Business | PL

Ekspert od wycen dedykowanych rozwiązań i zarządzania projektami. Posiada ogromne doświadczenie w tworzeniu ofert idealnie dopasowanych do potrzeb i oczekiwań klientów, specjalista łączący pasję do nowych wyzwań z analitycznym podejściem do każdego szczegółu projektu.

Sławomir Woźniak - Webtom.pl
Sławomir Woźniak | Webtom.pl

Share:

Facebook ikona
Facebook ikona
Linkedin ikona
Linkedin ikona
  • okno-pol logo okno-pol logo
  • piubello logo
    piubello logo
  • kabat logo
    kabat logo
  • komandor logo
    komandor logo
  • nbs logo
    nbs logo
  • josera logo
    josera logo
  • m-box24 logo
    m-box24 logo
  • edu bears logo
    edu bears logo
  • tapiso logo
    tapiso logo
  • farmutil hs logo
    farmutil hs logo
  • hjort knudsen logo
    hjort knudsen logo
  • sawex chemicals logo
    sawex chemicals logo
  • pik logo
    pik logo
  • gepa logisitcs logo
    gepa logisitcs logo
  • horpol logo
    horpol logo