Skip to main content

4️⃣ Google API atslēgas

Baltix izmanto divas Google atslēgas:

  • Pārlūka atslēga kartes attēlošanai norēķināšanās/pateicības lapā.
  • Servera atslēga ģeokodēšanai (adrese uz koordinātēm).
Bez atslēgas

Saņemšanas punktu atlasītājs darbojas arī bez Google Maps atslēgas — klienti redzēs saraksta skatu nevis karti. Pievienojot atslēgu, tiek iespējots kartes skats labākai pieredzei.

1. solis — Google Cloud projekta izveide​

  1. Dodieties uz Google Cloud Console

  2. Pierakstieties ar savu Google kontu (vai izveidojiet to)

  3. Noklikšķiniet uz Select a project augšējā joslā (1)

  4. Pēc tam uz New Project (2) Test

  5. Piešķiriet tam nosaukumu (piemēram, My Shopify Store) (3) un noklikšķiniet uz Create (4) Test

  6. Pēc tam dodieties uz projektu, noklikšķinot uz (1) un pēc tam (5)

Bezmaksas līmenis

Google piedāvā bezmaksas kredītu 200 $ mēnesī Maps API izmantošanai. Lielākajai daļai veikalu tas nozīmē, ka karte faktiski ir bezmaksas.

2. solis — Nepieciešamo API iespējošana​

Iespējojiet visas trīs API

Baltix nepieciešamas trīs Google Maps API. Jums jāiespējo visas trīs:

APINolūks
Maps JavaScript APIInteraktīva karte saņemšanas punktu atlasītājā norēķināšanās laikā
Geocoding APIServera puses adreses ģeokodēšana attāluma kārtošanai
Maps Static APIĢenerē kartes attēlu, kas rādīts pasūtījuma apstiprinājumā

Katrai API veiciet to pašu procesu:

  1. Meklējiet apis and services (2) joslā augšā (1)
  2. Noklikšķiniet uz APIs & Services

Test

  1. Pēc tam noklikšķiniet uz + Enable APIs and services

Test

  1. Meklēšanas laukā meklējiet API nosaukumu (piemēram, Maps JavaScript API)

Test

  1. Noklikšķiniet uz tā

Test

  1. Pēc tam noklikšķiniet uz Enable

Test

Atkārtojiet soļus 3–6 Geocoding API un Maps Static API.

Nepieciešams norēķinu konts

Google pieprasa, lai jūsu projektam būtu piesaistīts norēķinu konts, pat ja paliekat bezmaksas līmeņa ietvaros. Dodieties uz Billing konsolē, lai to iestatītu.

3. solis — Pārlūka atslēgas izveide (Maps)​

  1. Atgriezieties sadaļā APIs & Services
  2. Noklikšķiniet uz Credentials (1)

Test

  1. Pēc tam uz + Create Credentials (2)
  2. Pēc tam uz API key (3)

Test

  1. (Neobligāti) Piešķiriet atslēgai nosaukumu (4)
  2. Sadaļā Application restrictions atlasiet Websites (5)

Test

  1. Pievienojiet vietnes ierobežojumus.
Šis solis ir obligāts

Drošības apsvērumu dēļ šis aizsardzības solis ir obligāts, jo API atslēga tiks atklāta visiem klientiem. Tas nozīmē, ka ikviens varēs redzēt API atslēgu. Bez šiem ierobežojumiem ikviens, kas kopē šo atslēgu, varēs to izmantot.

Lai pievienotu jaunu vietni, noklikšķiniet uz Add (6). Pievienojiet savu Shopify domēnu un pielāgoto domēnu, ja tāds ir.

Piemēram, ja jūsu veikals ir baltic-fashion.myshopify.com ar pielāgotu domēnu www.baltic-fashion.com vai baltic-fashion.com: Jums jāpievieno tieši:

baltic-fashion.com/*
*.baltic-fashion.com/*
baltic-fashion.myshopify.com/*
shop.app/*
admin.shopify.com/*
Svarīgi MyShopify domēniem

Neizmantojiet tikai *.baltic-fashion.myshopify.com/*. Tas neatbilst saknes domēnam baltic-fashion.myshopify.com/* un izraisa RefererNotAllowedMapError.

Aizstājiet URL

Aizstājiet iepriekš minētos piemēra URL ar saviem veikala domēniem.

Test

  1. Noklikšķiniet uz Save (8)

Pēc tam iestatiet API ierobežojumus šai atslēgai uz:

  • Maps JavaScript API
  • Maps Static API

4. solis — Servera ģeokodēšanas atslēgas izveide​

Izveidojiet otro atslēgu sadaļā APIs & Services > Credentials:

  1. Noklikšķiniet uz + Create Credentials > API key
  2. Iestatiet Application restrictions uz None
  3. Iestatiet API restrictions tikai uz Geocoding API

Šai servera atslēgai neizmantojiet HTTP atsauces ierobežojumus.

5. solis — Ikdienas kvotas iestatīšana (neobligāti)​

Lai novērstu neparedzētas izmaksas, varat iestatīt ikdienas pieprasījumu ierobežojumu:

  1. Dodieties uz APIs & Services > Maps JavaScript API
  2. Noklikšķiniet uz cilnes Quotas
  3. Iestatiet ikdienas ierobežojumu (piemēram, 1000 pieprasījumi/dienā ir pietiekami lielākajai daļai veikalu)

6. solis — Atslēgu pievienošana Baltix​

  1. Atveriet Baltix lietotni savā Shopify administrācijā
  2. Dodieties uz Settings > General
  3. Ielīmējiet savu pārlūka atslēgu laukā Google Maps API Key
  4. Ielīmējiet savu servera atslēgu laukā Geocoding API Key (Server)
  5. Noklikšķiniet uz Save

Pārbaudiet, vai tas darbojas​

  1. Dodieties uz savu veikalu un pievienojiet produktu grozam
  2. Turpiniet uz norēķināšanos un atlasiet piegādes metodi, kas ir saistīta ar kurjeru
  3. Saņemšanas punktu atlasītājam jāparādās ar kartes skatu

Ja redzat saraksta skatu, bet nav kartes, pārbaudiet tālāk norādīto problēmu novēršanas sadaļu.

Problēmu novēršana​

ProblēmaRisinājums
Karte neparādāsPārliecinieties, ka visas trīs API ir iespējotas (2. solis)
Karte rādās, bet saņemšanas punkti nav pareizi centrētiPārliecinieties, ka Geocoding API ir iespējota un Geocoding API Key (Server) ir aizpildīts Baltix
Nav kartes attēla pasūtījuma apstiprinājumāPārliecinieties, ka Maps Static API ir iespējota
"ApiNotActivatedMapError" pārlūka konsolēIespējojiet norēķinu kontu savā Google Cloud projektā
"RefererNotAllowedMapError"Pārbaudiet savus HTTP atsauces ierobežojumus. Pievienojiet precīzu saknes domēnu (your-store.myshopify.com/*), nevis tikai *.your-store.myshopify.com/*
Karte ielādējas, bet rāda "For development purposes only"Piesaistiet norēķinu kontu savam Google Cloud projektam
Atslēga saglabāta, bet karte joprojām nerādāsUzgaidiet dažas minūtes — Google var aizņemt līdz 5 minūtēm jaunas atslēgas izplatīšanai