Skip to main content

4️⃣ Google API raktai

Baltix naudoja du Google raktus:

  • Naršyklės raktą žemėlapio rodymui atsiskaitymo / padėkos puslapiuose.
  • Serverio raktą geokodavimui (adreso pavertimui koordinatėmis).
Be rakto

Atsiėmimo punktų parinkiklis veikia ir be Google Maps rakto — klientai matys sąrašo rodinį vietoj žemėlapio. Pridėjus raktą, įgalinamas žemėlapio rodinys geresnei patirčiai.

1 žingsnis — Sukurti Google Cloud projektą​

  1. Eikite į Google Cloud Console

  2. Prisijunkite su savo Google paskyra (arba sukurkite naują)

  3. Viršutinėje juostoje spustelėkite Select a project (1)

  4. Tada New Project (2) Test

  5. Suteikite pavadinimą (pvz., My Shopify Store) (3) ir spustelėkite Create (4) Test

  6. Tada eikite į projektą spustelėdami (1) ir tada (5)

Nemokamas lygis

Google siūlo 200 USD/mėn. nemokamą kreditą Maps API naudojimui. Daugumai parduotuvių tai reiškia, kad žemėlapis iš esmės yra nemokamas.

2 žingsnis — Įgalinti reikiamas API​

Įgalinkite visas tris API

Baltix reikalingos trys Google Maps API. Turite įgalinti visas tris:

APIPaskirtis
Maps JavaScript APIInteraktyvus žemėlapis atsiėmimo punktų parinkiklyje atsiskaitant
Geocoding APIServerio pusės adresų geokodavimas atstumo rikiavimui
Maps Static APIGeneruoja žemėlapio vaizdą, rodomą užsakymo patvirtinime

Kiekvienai API laikykitės to paties proceso:

  1. Viršutinėje juostoje (1) ieškokite apis and services (2)
  2. Spustelėkite APIs & Services

Test

  1. Tada spustelėkite + Enable APIs and services

Test

  1. Paieškos laukelyje ieškokite API pavadinimo (pvz., Maps JavaScript API)

Test

  1. Spustelėkite ją

Test

  1. Tada spustelėkite Enable

Test

Pakartokite 3–6 žingsnius Geocoding API ir Maps Static API.

Reikalinga sąskaita

Google reikalauja, kad sąskaita būtų susieta su jūsų projektu, net jei liksitės nemokamo lygio ribose. Eikite į Billing konsolėje, kad ją nustatytumėte.

3 žingsnis — Sukurti naršyklės raktą (Maps)​

  1. Grįžkite į APIs & Services
  2. Spustelėkite Credentials (1)

Test

  1. Tada + Create Credentials (2)
  2. Tada API key (3)

Test

  1. (Neprivaloma) Suteikite raktui pavadinimą (4)
  2. Dalyje Application restrictions pasirinkite Websites (5)

Test

  1. Pridėkite svetainių apribojimus.
Šis žingsnis yra privalomas

Dėl saugumo priežasčių šis apsaugos žingsnis yra privalomas, nes API raktas bus matomas visiems klientams. Tai reiškia, kad bet kas galės matyti API raktą. Be šių apribojimų, bet kas, nukopijuodamas šį raktą, galės jį naudoti.

Norėdami pridėti naują svetainę, spustelėkite Add (6). Pridėkite savo Shopify domeną ir savo pasirinktinį domeną, jei jį turite.

Pavyzdžiui, jei jūsų parduotuvė yra baltic-fashion.myshopify.com su pasirinktinu domenu www.baltic-fashion.com arba baltic-fashion.com: Turite tiksliai pridėti:

baltic-fashion.com/*
*.baltic-fashion.com/*
baltic-fashion.myshopify.com/*
shop.app/*
admin.shopify.com/*
Svarbu dėl MyShopify domenų

Nenaudokite tik *.baltic-fashion.myshopify.com/*. Tai neatitinka šakninio domeno baltic-fashion.myshopify.com/* ir sukelia RefererNotAllowedMapError.

Pakeiskite URL

Aukščiau pateiktus URL pavyzdžius pakeiskite savo parduotuvės domenais.

Test

  1. Spustelėkite Save (8)

Tada nustatykite šio rakto API apribojimus:

  • Maps JavaScript API
  • Maps Static API

4 žingsnis — Sukurti serverio geokodavimo raktą​

Sukurkite antrą raktą APIs & Services > Credentials:

  1. Spustelėkite + Create Credentials > API key
  2. Nustatykite Application restrictions į None
  3. Nustatykite API restrictions tik į Geocoding API

Šiam serverio raktui nenaudokite HTTP nukreipimo apribojimų.

5 žingsnis — Nustatyti dienos kvotas (neprivaloma)​

Norėdami išvengti netikėtų mokesčių, galite nustatyti dienos užklausų limitą:

  1. Eikite į APIs & Services > Maps JavaScript API
  2. Spustelėkite skirtuką Quotas
  3. Nustatykite dienos limitą (pvz., 1 000 užklausų per dieną yra daugiau nei pakankamai daugumai parduotuvių)

6 žingsnis — Pridėti raktus Baltix​

  1. Atidarykite Baltix programą savo Shopify administravimo srityje
  2. Eikite į Settings > General
  3. Įklijuokite naršyklės raktą į Google Maps API Key
  4. Įklijuokite serverio raktą į Geocoding API Key (Server)
  5. Spustelėkite Save

Patikrinkite, ar veikia​

  1. Eikite į savo parduotuvę ir pridėkite produktą į krepšelį
  2. Atsiskaitykite ir pasirinkite siuntimo metodą, susietą su vežėju
  3. Atsiėmimo punktų parinkiklis turėtų rodyti žemėlapio rodinį

Jei matote sąrašo rodinį, bet ne žemėlapį, peržiūrėkite žemiau esantį trikčių šalinimo skyrių.

Trikčių šalinimas​

ProblemaSprendimas
Žemėlapis nerodomasĮsitikinkite, kad visos trys API įgalintos (2 žingsnis)
Žemėlapis rodomas, bet atsiėmimo punktai necentruojami teisingaiĮsitikinkite, kad Geocoding API įgalinta ir Geocoding API Key (Server) užpildytas Baltix
Žemėlapio vaizdas nerodomas užsakymo patvirtinimeĮsitikinkite, kad Maps Static API įgalinta
„ApiNotActivatedMapError" naršyklės konsolėjeĮgalinkite atsiskaitymą savo Google Cloud projekte
„RefererNotAllowedMapError"Patikrinkite HTTP nukreipimo apribojimus. Pridėkite tikslų šakninį domeną (your-store.myshopify.com/*), o ne tik *.your-store.myshopify.com/*
Žemėlapis įkeltas, bet rodoma „For development purposes only"Susiekite atsiskaitymo paskyrą su savo Google Cloud projektu
Raktas išsaugotas, bet žemėlapis vis dar nerodomasPalaukite kelias minutes — Google naujo rakto platinimas gali užtrukti iki 5 minučių