Liigu peamise sisu juurde

4️⃣ Google API võtmed

Baltix kasutab kahte Google võtit:

  • Brauseri võti kaardi kuvamiseks kassas/tänu lehel.
  • Serveri võti geokodeerimiseks (aadressist koordinaatideks).
Ilma võtmeta

Pakipunkti valija töötab ka ilma Google Maps võtmeta — kliendid näevad loendivaadet kaardi asemel. Võtme lisamine võimaldab kaardivaadet parema kasutuskogemuse jaoks.

1. samm — Looge Google Cloud projekt​

  1. Minge Google Cloud Console'i

  2. Logige sisse oma Google kontoga (või looge üks)

  3. Klõpsake ülaosas Select a project (1)

  4. Seejärel New Project (2) Test

  5. Andke sellele nimi (nt My Shopify Store) (3) ja klõpsake Create (4) Test

  6. Seejärel minge projekti, klõpsates (1) ja seejärel (5)

Tasuta kasutustase

Google pakub Maps API kasutamiseks $200/kuu tasuta krediiti. Enamiku poodide jaoks tähendab see, et kaart on tegelikult tasuta.

2. samm — Lubage vajalikud API-d​

Lubage kõik kolm API-d

Baltix vajab kolme Google Maps API-d. Peate lubama kõik kolm:

APIEesmärk
Maps JavaScript APIInteraktiivne kaart pakipunkti valijas kassas
Geocoding APIServeripoolne aadressi geokodeerimine kauguse sortimiseks
Maps Static APIGenereerib tellimuse kinnituses kuvatava kaardipildi

Iga API jaoks järgige sama protsessi:

  1. Otsige ülaosas (1) asuvast ribast apis and services (2)
  2. Klõpsake APIs & Services

Test

  1. Seejärel klõpsake + Enable APIs and services

Test

  1. Otsige otsinguväljas API nime (nt Maps JavaScript API)

Test

  1. Klõpsake sellel

Test

  1. Seejärel klõpsake Enable

Test

Korrake samme 3–6 Geocoding API ja Maps Static API jaoks.

Areldamine on nõutav

Google nõuab, et teie projektiga oleks seotud arelduskonto, isegi kui jääte tasuta kasutustaseme piiridesse. Selle seadistamiseks minge konsoolis Billing lehele.

3. samm — Looge brauseri võti (Maps)​

  1. Minge tagasi APIs & Services lehele
  2. Klõpsake Credentials (1)

Test

  1. Seejärel + Create Credentials (2)
  2. Seejärel API key (3)

Test

  1. (Valikuline) Andke võtmele nimi (4)
  2. Rakenduse piirangute all valige Websites (5)

Test

  1. Lisage veebisaidi piirangud.
See samm on kohustuslik

Turvakaalutlustel on see kaitsemeede kohustuslik, kuna API võti on kõigile klientidele nähtav. See tähendab, et kõik saavad API võtit näha. Ilma nende piiranguteta saab keegi, kes selle võtme kopeerib, seda kasutada.

Uue veebisaidi lisamiseks klõpsake Add (6). Lisage oma Shopify domeen ja oma kohandatud domeen, kui teil see on.

Näiteks, kui teie pood on baltic-fashion.myshopify.com kohandatud domeeniga www.baltic-fashion.com või baltic-fashion.com: Peate lisama täpselt:

baltic-fashion.com/*
*.baltic-fashion.com/*
baltic-fashion.myshopify.com/*
shop.app/*
admin.shopify.com/*
Oluline MyShopify domeenide jaoks

Ärge kasutage ainult *.baltic-fashion.myshopify.com/*. See ei vasta juurdomreenile baltic-fashion.myshopify.com/* ja põhjustab RefererNotAllowedMapError.

Asendage URL-id

Asendage ülaltoodud näite URL-id oma poe domeenidega.

Test

  1. Klõpsake Save (8)

Seejärel seadistage selle võtme API piirangud:

  • Maps JavaScript API
  • Maps Static API

4. samm — Looge serveri geokodeerimise võti​

Looge teine võti jaotises APIs & Services > Credentials:

  1. Klõpsake + Create Credentials > API key
  2. Seadistage Application restrictions väärtusele None
  3. Seadistage API restrictions ainult Geocoding API jaoks

Ärge kasutage selle serveri võtme jaoks HTTP viitaja piiranguid.

5. samm — Seadistage päevased kvoodid (valikuline)​

Ootamatute kulude vältimiseks saate seada päevase päringu limiidi:

  1. Minge APIs & Services > Maps JavaScript API
  2. Klõpsake vahekaarti Quotas
  3. Seadistage päevane limiit (nt 1000 päringut/päevas on enamiku poodide jaoks piisav)

6. samm — Lisage võtmed Baltixis​

  1. Avage Baltix rakendus oma Shopify administraatoris
  2. Minge Settings > General
  3. Kleepige oma brauseri võti väljale Google Maps API Key
  4. Kleepige oma serveri võti väljale Geocoding API Key (Server)
  5. Klõpsake Save

Kontrollige, kas see töötab​

  1. Minge oma poodi ja lisage toode ostukorvi
  2. Jätkake kassasse ja valige vedajaga seotud tarnimisviis
  3. Pakipunkti valija peaks ilmuma kaardivaadetega

Kui näete loendivaadet, kuid mitte kaarti, vaadake allpool tõrkeotsingut.

Tõrkeotsing​

ProbleemLahendus
Kaart ei ilmuVeenduge, et kõik kolm API-d on lubatud (samm 2)
Kaart kuvatakse, kuid pakipunktid pole õigesti tsentreeritudVeenduge, et Geocoding API on lubatud ja Geocoding API Key (Server) on Baltixis täidetud
Tellimuse kinnituses puudub kaardipiltVeenduge, et Maps Static API on lubatud
Brauseri konsoolis kuvatakse "ApiNotActivatedMapError"Lubage oma Google Cloud projektil areldamine
"RefererNotAllowedMapError"Kontrollige oma HTTP viitaja piiranguid. Lisage täpne juurdomeen (your-store.myshopify.com/*) ja mitte ainult *.your-store.myshopify.com/*
Kaart laadib, kuid näitab "For development purposes only"Linkige arelduskonto oma Google Cloud projektiga
Võti salvestatud, kuid kaart ei kuva endiseltOodake mõni minut — Google võib võtme levitamiseks kuluda kuni 5 minutit