Beveik kiekvienoje Shopify temoje yra žemėlapio sekcija - „kur mus rasti" blokas kontaktų puslapyje. Ir beveik kiekvienoje ji pirmą kartą įjungta rodo pilką dėžutę arba pranešimą, kad reikia API rakto.
Priežastis paprasta: Google nebeleidžia rodyti savo žemėlapių be rakto. Gera žinia - tipinei e-parduotuvei tai vis tiek nieko nekainuoja. Reikia maždaug 15 minučių ir vieno žingsnio, kurio dauguma nepadaro: rakto apribojimo.
Ar jums tikrai reikia API rakto
Priklauso nuo to, ko norite.
Jei tereikia paprasto žemėlapio kontaktų puslapyje, rakto galite ir neprireikti. Google Maps svetainėje susiraskite savo adresą, spauskite Bendrinti → Įterpti žemėlapį ir gautą iframe kodą įklijuokite į Shopify puslapį per HTML redagavimą. Veikia iš karto, nemokamai, be jokių nustatymų.
Raktas būtinas tada, kai naudojate temos žemėlapio sekciją - tą, kuri turi savo spalvų stilių, žymeklį su jūsų logotipu ar kelias parduotuvių vietas. Tokios sekcijos remiasi Maps JavaScript API, o šis be rakto paprasčiausiai neužsikraus. Tas pats galioja parduotuvių žemėlapiams (store locator) ir adreso automatiniam užpildymui checkout'e per papildomas programėles.
Kaip susikurti Google Maps API raktą
1. Sukurkite Google Cloud projektą
Eikite į Google Cloud Console ir prisijunkite su ta Google paskyra, kurią naudosite ilgai - geriausia įmonės, ne asmenine. Viršuje spauskite projekto pasirinkimą → New Project ir pavadinkite jį suprantamai, pavyzdžiui „Parduotuve-Maps". Jei Google Cloud jau naudojate, galite naudoti esamą projektą.
2. Įjunkite atsiskaitymą
Google Maps Platform reikalauja susietos atsiskaitymo paskyros net ir nemokamam naudojimui. Console → Billing → susiekite atsiskaitymo paskyrą su projektu. Naujiems Google Cloud klientams suteikiamas 300 USD sveikinimo kreditas, galiojantis 90 dienų.
Jei nenorite iš karto įvesti kortelės, Google turi Maps Demo Key - laikiną raktą prototipams be atsiskaitymo duomenų. Jis tinka pasižiūrėti, ar sekcija apskritai veikia, bet gyvai parduotuvei netinka: yra dienos limitai, o juos pasiekus žemėlapis tiesiog nustoja rodytis iki kitos dienos.
3. Įjunkite reikiamus API
Console → APIs & Services → Enable APIs and Services. Įjunkite tik tai, ko reikia:
- Maps JavaScript API - interaktyviai temos žemėlapio sekcijai
- Maps Embed API - jei tema naudoja paprastą iframe
- Geocoding API - jei sekcijoje įvedate adresą tekstu, o ne koordinatėmis
- Places API - jei kur nors reikia adreso paieškos su pasiūlymais
Daugumai Shopify temų užtenka pirmojo, dažnai kartu su Geocoding. Neįjunkite visko iš eilės - kuo mažiau įjungtų paslaugų, tuo mažesnė rizika, jei raktas kada nors nutekėtų.
4. Sukurkite raktą
Console → APIs & Services → Credentials → Create credentials → API key. Gausite ilgą simbolių eilutę - tai ir yra jūsų raktas. Nusikopijuokite jį, bet lango dar neuždarykite.
5. Apribokite raktą
Šis žingsnis yra svarbiausias ir dažniausiai praleidžiamas. Neapribotas raktas yra viešai matomas jūsų parduotuvės kode - bet kas gali jį pasiimti ir naudoti savo projekte jūsų sąskaita.
Tame pačiame rakto lange:
-
Application restrictions → pasirinkite Websites ir įrašykite savo domenus. Nurodykite pilną adresą su protokolu:
https://jusuparduotuve.lt/*,https://*.jusuparduotuve.lt/*ir būtinaihttps://jusuparduotuve.myshopify.com/*- be pastarojo žemėlapis neveiks temos redaktoriaus peržiūroje. - API restrictions → pasirinkite Restrict key ir pažymėkite tik tuos API, kuriuos įjungėte 3 žingsnyje.
- Spauskite Save. Pakeitimai įsigalioja per kelias minutes.
Papildomai verta Billing skiltyje nustatyti biudžeto įspėjimą, pavyzdžiui 10 EUR. Jei kas nors negerai - sužinosite el. paštu, o ne mėnesio pabaigoje.
6. Įklijuokite raktą į temą
Shopify Admin → Online Store → Themes → Customize → susiraskite žemėlapio sekciją → laukelis Google Maps API key. Įklijuokite raktą, išsaugokite ir perkraukite peržiūrą. Jei žemėlapis vis dar tuščias, palaukite 2-5 minutes: apribojimai įsigalioja ne akimirksniu.
Kiek tai realiai kainuoja
Nuo 2025 m. kovo Google atsisakė bendro 200 USD mėnesinio kredito ir vietoje jo kiekvienai paslaugai skiria atskirą nemokamą limitą per mėnesį: 10 000 užklausų Essentials lygio paslaugoms (tarp jų Maps JavaScript API ir Geocoding), 5 000 - Pro ir 1 000 - Enterprise lygio paslaugoms.
Ką tai reiškia praktiškai: 10 000 žemėlapio įkėlimų per mėnesį yra maždaug tiek, kiek kontaktų puslapį aplanko vidutinė Lietuvos e-parduotuvė. Daugumai verslų sąskaita lieka 0 EUR. Maps Embed API apskritai nemokamas be užklausų limito.
Rizika atsiranda tik dviem atvejais: kai žemėlapis įdėtas į kiekvieną puslapį (pvz., į footer'į) arba kai neapribotą raktą pasisavina svetimi.
Dažniausios klaidos
- Neįjungtas billing. Raktas sukurtas, API įjungtas, bet žemėlapis rodo klaidą - 90 % atvejų tai neprisegta atsiskaitymo paskyra.
- Pamirštas myshopify.com domenas. Gyvai veikia, temos redaktoriuje - ne.
- Raktas be apribojimų. Veikia puikiai, kol kas nors jo neranda jūsų kode.
- Neįjungtas Geocoding API. Tema prašo adreso tekstu, bet negali jo paversti koordinatėmis - žemėlapis lieka tuščias.
- Raktas įrašytas tiesiai į temos kodą. Visada naudokite sekcijos nustatymų laukelį - taip jį lengva pakeisti be programuotojo.
Ką daryti toliau
Jei žemėlapis vis dar neveikia arba jums reikia kelių parduotuvių žemėlapio, filtruojamo store locator'io ar adreso automatinio užpildymo checkout'e, tai jau Shopify programavimo darbų sritis. Parašykite mums per kontaktus - pasakysime, ar tai kelių valandų darbas, ar reikia atskiro sprendimo.
