> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Uzyskaj klucze Google do mapy punktów odbioru i wyszukiwania adresów

> Utwórz dwa klucze na własnym koncie Google Cloud i dodaj je w Zippendo, aby klienci mogli wybrać punkt odbioru na mapie i wyszukać adres w kasie Shopify.

Twoi klienci już teraz mogą wybrać punkt odbioru z listy. Przy kasie mogą go wyszukać po kodzie pocztowym lub nazwie punktu odbioru, a w koszyku po kodzie pocztowym. Dzięki dwóm kluczom z Twojego własnego konta Google możesz dać im więcej:

* **Klucz Google Maps** pokazuje mapę z pinezką dla każdego punktu odbioru, w [wyborze punktu odbioru przy kasie](https://www.zippendo.com/docs/pl/tutorials/shopify-service-point-picker.md) i w [wyborze punktu odbioru w koszyku](https://www.zippendo.com/docs/pl/tutorials/shopify-cart-service-points.md).
* **Klucz Google do wyszukiwania adresów** pozwala klientom wyszukać przy kasie dowolny adres lub okolicę i przesunąć mapę, aby zobaczyć punkty odbioru w tym miejscu.

Oba klucze są opcjonalne i możesz dodać jeden bez drugiego. Bez nich wszystko nadal działa z listą. Utworzenie kluczy w Google Cloud zajmuje około 15 minut, a ta strona prowadzi Cię przez każde kliknięcie.

> [!NOTE]
>
> **Czego potrzebujesz**
>
> * Wybór punktu odbioru skonfigurowany w kasie Shopify albo punkty odbioru w koszyku. Zobacz [Dodaj wybór punktu odbioru do kasy Shopify](https://www.zippendo.com/docs/pl/tutorials/shopify-service-point-picker.md) lub [Pozwól klientom wybrać punkt odbioru w koszyku Shopify](https://www.zippendo.com/docs/pl/tutorials/shopify-cart-service-points.md).
> * Konto Google.
> * Karta płatnicza. Google prosi o skonfigurowanie płatności, zanim klucz Google zacznie działać, także wtedy, gdy mieścisz się w bezpłatnym miesięcznym limicie.

## Ile to kosztuje

Google co miesiąc daje Ci bezpłatny limit użycia i pobiera opłaty za użycie ponad ten limit. Mapa jest liczona za każdym razem, gdy klient ją otwiera. Wyszukiwanie adresów jest liczone przy każdym wyszukiwaniu i za każdym razem, gdy klient przesuwa mapę. Aktualne ceny Google znajdziesz na stronie [Cennik Google Maps Platform](https://mapsplatform.google.com/pricing/). W Google Cloud możesz ustawić alert budżetowy, aby Google wysłał Ci e-mail, zanim rachunek urośnie. Alert budżetowy nie wstrzymuje opłat: aby ograniczyć koszt wyszukiwania adresów, ustaw też dzienny limit żądań (przydział) dla Geocoding API.

## Krok 1: Utwórz projekt w Google Cloud

**1. Zaloguj się do Google Cloud**

Wejdź na [console.cloud.google.com](https://console.cloud.google.com) i zaloguj się na swoje konto Google.

**2. Utwórz projekt**

Utwórz nowy projekt i nadaj mu nazwę, którą rozpoznasz, na przykład „Mapa sklepu”.

**3. Skonfiguruj płatności**

Gdy Google o to poprosi, dodaj konto rozliczeniowe ze swoją kartą płatniczą.

## Krok 2: Włącz interfejsy API

W swoim projekcie otwórz **Google Maps Platform** i włącz (Enable) te dwa interfejsy:

* **Maps JavaScript API**: pokazuje mapę na stronie internetowej, na przykład w Twojej kasie.
* **Geocoding API**: pozwala klientom wyszukać adres lub okolicę i przesuwać mapę, aby zobaczyć znajdujące się tam punkty odbioru.

## Krok 3: Utwórz klucz do mapy i ogranicz go do swojego sklepu internetowego

W **Google Maps Platform** otwórz **Keys & Credentials**, kliknij **Create credentials** i wybierz **API key**. Google pokaże Twój nowy klucz: długi kod zaczynający się od „AIza”. Skopiuj go.

Klucz bez ograniczeń działa na każdej stronie internetowej, więc ktoś inny mógłby go użyć, a rachunek za jego mapy trafiłby do Ciebie. Ogranicz go do adresów, na których Twoi klienci składają zamówienia.

**1. Otwórz ustawienia klucza**

Kliknij nazwę swojego nowego klucza.

**2. Zezwól tylko na adresy swojego sklepu internetowego**

W sekcji **Application restrictions** wybierz **Websites**. W sekcji **Website restrictions** dodaj po kolei każdy adres, na którym Twoi klienci składają zamówienia:

* Swoją własną domenę, na przykład `https://nordlysliving.dk/*`, oraz tę samą z `*.` na początku, na przykład `https://*.nordlysliving.dk/*`, aby objąć adresy takie jak [www](http://www). i checkout.
* Swój adres Shopify, na przykład `https://nordlys-living.myshopify.com/*`.
* `https://shop.app/*`, jeśli dla bloku wyboru punktu odbioru masz włączone **Include block in Shop Pay**.

**3. Zezwól tylko na mapę**

W sekcji **API restrictions** wybierz **Restrict key** i zaznacz tylko **Maps JavaScript API**.

**4. Zapisz**

Kliknij **Save**. Nowe ograniczenia mogą zacząć działać dopiero po kilku minutach.

> [!TIP]
>
> Nie wiesz, jakiego adresu używa Twoja kasa? Rozpocznij zamówienie w swoim sklepie internetowym i spójrz na pasek adresu przeglądarki. Ten adres musi być na liście.

## Krok 4: Utwórz klucz do wyszukiwania adresów

Wyszukiwanie adresów wymaga drugiego klucza. W przeciwieństwie do klucza do mapy nie może on być ograniczony do witryn internetowych, bo inaczej wyszukiwanie adresów nie będzie działać.

**1. Utwórz drugi klucz**

W **Keys & Credentials** kliknij **Create credentials** i ponownie wybierz **API key**. Skopiuj nowy klucz.

**2. Zezwól tylko na wyszukiwanie adresów**

Kliknij nazwę nowego klucza. W sekcji **API restrictions** wybierz **Restrict key** i zaznacz tylko **Geocoding API**.

**3. Nie ograniczaj witryn**

W sekcji **Application restrictions** wybierz **None**. Klucz zezwala tylko na Geocoding API, więc nikt nie może go użyć do wyświetlania map.

**4. Zapisz**

Kliknij **Save**.

> [!WARNING]
>
> Użyj dwóch różnych kluczy. Wyszukiwanie adresów nie działa z kluczem ograniczonym do witryn internetowych, więc jeden klucz nie może obsłużyć obu funkcji.

Google od czasu do czasu zmienia nazwy swoich menu. Jeśli nazwa podana tutaj nie zgadza się z tym, co widzisz na ekranie, aktualne kroki znajdziesz we własnym przewodniku Google [Używanie kluczy API](https://developers.google.com/maps/documentation/javascript/get-api-key).

## Krok 5: Dodaj klucze w Zippendo

**1. Otwórz swój sklep internetowy**

Kliknij **Kanały sprzedaży** na pasku bocznym. Na karcie **Połączone** kliknij swój sklep internetowy Shopify. Otworzy się karta **Zamówienia i kasa**.

**2. Wklej klucz do mapy**

Na karcie **Punkty odbioru przy kasie** albo na karcie **Punkty odbioru w koszyku** wklej klucz do mapy w polu **Klucz Google Maps (opcjonalny)** i kliknij **Zapisz klucz**. Zobaczysz komunikat **Zapisano klucz Google**. Obie karty korzystają z tych samych kluczy, więc dodajesz je tylko raz.

**3. Wklej klucz do wyszukiwania adresów**

Na karcie **Punkty odbioru przy kasie** wklej drugi klucz w polu **Klucz Google do wyszukiwania adresów (opcjonalny)** i kliknij **Zapisz klucz**. Jeśli Google zaakceptuje klucz, zobaczysz komunikat **Zapisano klucz Google**, a w polu pojawi się tekst **Klucz zapisany. Wklej nowy klucz, aby go zastąpić.** Koszyk nie ma wyszukiwania adresów, więc jego karta pokazuje tylko klucz do mapy.

![Pole Klucz Google Maps (opcjonalny) z zapisanym kluczem i pole Klucz Google do wyszukiwania adresów (opcjonalny) z tekstem „Klucz zapisany. Wklej nowy klucz, aby go zastąpić.”, z przyciskami Zapisz klucz i Usuń klucz](https://mintcdn.com/zippendo/cPFBHhpG6rolz2WC/images/how-to/google-maps-key/03-zippendo-keys-light.png?fit=max\&auto=format\&n=cPFBHhpG6rolz2WC\&q=85\&s=a54f62e7b8caa8987618d9f4103a1de4)

Dwa pola na klucze na karcie Punkty odbioru przy kasie

Po zapisaniu klucza do wyszukiwania adresów Zippendo nie pokazuje go już ponownie. Aby go usunąć, kliknij **Usuń klucz**. Aby usunąć klucz do mapy, wyczyść jego pole i kliknij **Zapisz klucz**.

## Sprawdź, czy to działa

Rozpocznij zamówienie w swoim sklepie internetowym, wybierz swoją metodę dostawy z punktem odbioru i kliknij **Zmień punkt odbioru**. Z kluczem do wyszukiwania adresów pole wyszukiwania nad listą pokazuje tekst **Adres, kod pocztowy lub nazwa punktu odbioru**.

Z kluczem do mapy Twoi klienci mogą przełączać się między **Lista** a **Mapa**. **Mapa** otwiera mapę, na której każdy punkt odbioru ma pinezkę z logo przewoźnika. Jeśli dodasz też klucz do wyszukiwania adresów, klienci mogą wyszukać adres lub kod pocztowy nad mapą albo po prostu przesunąć mapę, a pojawią się punkty odbioru w tym miejscu.

![Okno Wybierz punkt odbioru w kasie Shopify z polem wyszukiwania adresu lub kodu pocztowego nad mapą Google, na której widać Kopenhagę, i pinezką GLS przy każdym punkcie odbioru](https://mintcdn.com/zippendo/cPFBHhpG6rolz2WC/images/how-to/google-maps-key/01-checkout-map.png?fit=max\&auto=format\&n=cPFBHhpG6rolz2WC\&q=85\&s=021bb7eafed15dbd35cdf30f6d44c999)

Mapa, którą widzą Twoi klienci po kliknięciu opcji Mapa

Po kliknięciu pinezki klienci widzą nazwę, adres i godziny otwarcia punktu odbioru. Przycisk **Wybierz** zatwierdza wybór punktu i zamyka mapę.

![Otwarta pinezka na mapie z informacjami: Silvan Vesterbrogade, Vesterbrogade 10, København V, otwarte pon.–niedz. 09:00–19:00, oraz przycisk Wybierz](https://mintcdn.com/zippendo/cPFBHhpG6rolz2WC/images/how-to/google-maps-key/02-checkout-map-pin.png?fit=max\&auto=format\&n=cPFBHhpG6rolz2WC\&q=85\&s=02c77381f26dc3937ed3cb3ced24dc46)

Kliknij pinezkę, a potem Wybierz

## Coś nie działa?

* **Nie ma mapy.** Skopiuj ponownie klucz do mapy z Google Cloud i wklej cały klucz. Porównaj adres widoczny w przeglądarce podczas składania zamówienia z ustawieniami **Website restrictions** klucza i sprawdź, czy Maps JavaScript API jest włączone, a płatności są skonfigurowane. Gdy kasa pokazuje metody dostawy w oknie nad stroną, nie ma przycisku **Mapa**: Shopify nie pozwala tam na mapę.
* **Zippendo pokazuje komunikat Google nie zaakceptował tego klucza.** Klucz do wyszukiwania adresów jest ograniczony do witryn internetowych albo Geocoding API nie jest dla niego włączone. Popraw jedno i drugie w Google Cloud albo utwórz nowy klucz jak w kroku 4.
* **Klienci nie mogą wyszukać adresu albo przesunięcie mapy nie pokazuje nowych punktów odbioru.** Sprawdź, czy klucz do wyszukiwania adresów jest zapisany oraz czy Geocoding API jest nadal włączone, a płatności są skonfigurowane w Twoim projekcie Google Cloud.
* **Klucz został dopiero co zmieniony.** Odczekaj kilka minut i spróbuj ponownie.

## Kto co widzi

Mapa pochodzi bezpośrednio od Google i korzysta z Twojego klucza do mapy. Gdy klient wyszukuje adres lub przesuwa mapę, Zippendo przekazuje do Google to, co wpisał, albo miejsce na mapie, z użyciem Twojego klucza do wyszukiwania adresów. Oba klucze działają na podstawie Twojej własnej umowy z Google, a Google obciąża Twoje konto.

Powiązane: [Dodaj wybór punktu odbioru do kasy Shopify](https://www.zippendo.com/docs/pl/tutorials/shopify-service-point-picker.md) · [Wybór punktu odbioru przy kasie](https://www.zippendo.com/docs/pl/order-channels/shopify-checkout-pickup-picker.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.