Přeskočit na obsah
Globe Pickup Points

Google Maps API klíče

Globe Pickup Points podporuje dva volitelné Google API klíče pro vylepšení zážitku vašich zákazníků při výběru výdejních míst:

  1. Google Maps JavaScript API klíč (doporučeno) - Zobrazuje interaktivní mapu s umístěním výdejních míst
  2. Google Places API klíč (volitelné) - Slouží k vyhledávání adresy v mapě s funkcemi autocomplete a přesnějšími výsledky

Oba klíče jsou volitelné, ale Google Maps API klíč je doporučen pro nejlepší zákaznickou zkušenost. Bez nich mohou zákazníci stále vybírat výdejní místa z rozbalovacího seznamu.

Co když Places API klíč nevyplním?

Vyhledávání adres v mapě bude fungovat i bez Places API klíče — jen nebude tak přesné a nebude k dispozici autocomplete (doplnění adresy při psaní). Pokud chcete nejlepší zkušenost s vyhledáváním, doporučujeme Places API klíč vyplnit.

Vytvoření Google Maps JavaScript API klíče

Tento klíč umožňuje zobrazení interaktivní mapy s umístěním výdejních míst.

  1. Přejděte na Google Cloud Platform Console.
  2. Pokud ještě nemáte projekt, vytvořte ho kliknutím na ‘Nový projekt’ a postupujte podle pokynů na obrazovce.
  3. Jakmile je váš projekt připraven, přejděte na dashboard ‘APIs & Services’ a klikněte na ‘Enable APIs and Services’.
  4. Do vyhledávacího pole napište Google Maps JavaScript API a vyberte ho. Poté klikněte na ‘Enable’ pro aktivaci API pro váš projekt.

Google maps

  1. Po povolení API přejděte na záložku ‘Credentials’ a klikněte na ’+ Create Credentials’. Vyberte ‘API key’ z rozbalovacího menu. Váš nový API klíč bude vytvořen a zobrazen na obrazovce.

Credentials

  1. Omezte svůj API klíč pro zabránění neoprávněnému použití:
    • Klikněte na ‘Edit API Key’ (nebo ikonu tužky vedle vašeho klíče)
    • Pod ‘Application restrictions’ vyberte ‘Websites’
    • Přidejte následující referrer domény pro omezení použití API klíče na váš Shopify obchod:
      • *.[MERCHANT-DOMAIN].com (nahraďte vaší skutečnou doménou)
      • *.myshopify.com
      • [MERCHANT-DOMAIN].com (nahraďte vaší skutečnou doménou)
      • https://shop.app
      • https://shopify.com
      • Zahrňte jakékoli další domény, na kterých váš obchod funguje
    • Pod ‘API restrictions’ vyberte ‘Restrict key’ a zvolte pouze ‘Maps JavaScript API’

Credentials

  1. Klikněte na ‘Save’ pro uložení nastavení.

Pro detailní instrukce se podívejte na oficiální Google průvodce pro získání API klíče.

Vytvoření Google Places API klíče

Tento klíč slouží k vyhledávání adresy v mapě — zákazníci mohou psát adresu a díky autocomplete dostávat návrhy při psaní. Výdejní místa se pak zobrazí v blízkosti zadané adresy. Bez tohoto klíče vyhledávání funguje, ale bez autocomplete a s menší přesností.

  1. Ve stejné Google Cloud Platform Console použijte stejný projekt, který jste vytvořili pro Maps API.
  2. Přejděte na dashboard ‘APIs & Services’ a klikněte na ‘Enable APIs and Services’.
  3. Do vyhledávacího pole napište Places API (New) a vyberte ho. Poté klikněte na ‘Enable’ pro aktivaci API pro váš projekt.

  1. Po povolení API přejděte na záložku ‘Credentials’ a klikněte na ’+ Create Credentials’. Vyberte ‘API key’ z rozbalovacího menu.

  2. Důležité: Dejte tomuto klíči popisný název jako “Places API Key”, aby se odlišil od vašeho Maps JavaScript API klíče.

  3. Omezte tento API klíč:

    • Klikněte na ‘Edit API Key’
    • Pod ‘Application restrictions’ vyberte ‘None’ (tento klíč je používán pouze na straně serveru, ne v prohlížeči)
    • Pod ‘API restrictions’ vyberte ‘Restrict key’ a zvolte pouze ‘Places API (New)‘

  4. Klikněte na ‘Save’ pro uložení nastavení.

Přidání API klíčů do Globe Pickup Points

Po vytvoření vašich API klíčů je integrujte do aplikace Globe Pickup Points:

  1. Přihlaste se do vaší Shopify administrace.
  2. Přejděte do aplikace Globe Pickup Points.
  3. Přejděte na stránku Nastavení.
  4. Najdete zde dvě oddělená pole:
    • Google Maps API klíč (doporučeno) - Vložte sem váš Maps JavaScript API klíč pro povolení interaktivní mapy
    • Google Places API klíč (volitelné) - Vložte sem váš Places API klíč pro vyhledávání adres v mapě s autocomplete. Bez něj vyhledávání funguje, ale je méně přesné a bez doplnění adresy.
  5. Můžete přidat jeden nebo oba klíče v závislosti na tom, které funkce chcete povolit.
  6. Klikněte na Uložit pro uložení změn.

Nastavením těchto API klíčů povolíte vylepšený výběr výdejních míst založený na mapě s funkcí vyhledávání lokací, což výrazně zlepší zkušenost vašich zákazníků.

Map view