Google Maps API kulcsok

A Globe Pickup Points két opcionális Google API kulcsot támogat az ügyfelek csomagátvételi pont kiválasztási élményének javításához:

1. Google Maps JavaScript API kulcs (ajánlott) - Interaktív térképet jelenít meg a csomagátvételi pontok helyzetével
2. Google Places API kulcs (opcionális) - A térképen belüli cím kereséséhez autocomplete funkciókkal és pontosabb eredményekkel

Mindkét kulcs opcionális, de a Google Maps API kulcs ajánlott a legjobb ügyfélélmény érdekében. Nélkülük az ügyfelek legördülő listából is választhatnak csomagátvételi pontot.

Mi történik, ha nem töltöm ki a Places API kulcsot?

A cím keresés a térképen Places API kulcs nélkül is működik — csak nem lesz olyan pontos, és nem lesz elérhető az autocomplete (a cím gépelés közbeni kiegészítése). Ha a legjobb keresési élményt szeretné, javasoljuk a Places API kulcs megadását.

Ingyenes korlát

A Google Maps szolgáltatások fizetősek, de van egy nagyvonalú ingyenes korlát.

Az ingyenes korlát általában elegendő a legtöbb Shopify áruház számára (legfeljebb 10 000 térképmegjelenítés). A Google Maps árképzéséről bővebb információt itt talál.

A Google 2025 márciusától frissítette az árait. A legfrissebb információkért tekintse meg az árkalkulátor oldalt.

Google Maps JavaScript API kulcs létrehozása

Ez a kulcs lehetővé teszi az interaktív térkép megjelenítését a csomagátvételi pontok helyzetével.

1. Lépjen a Google Cloud Platform Console oldalra.
2. Ha még nincs projektje, hozzon létre egyet az ‘Új projekt’ gombra kattintva, majd kövesse a képernyőn megjelenő utasításokat.
3. Amint a projekt készen áll, lépjen az ‘APIs & Services’ irányítópultra, és kattintson az ‘Enable APIs and Services’ lehetőségre.
4. A keresőmezőbe írja be a Google Maps JavaScript API kifejezést, és válassza ki. Ezután kattintson az ‘Enable’ gombra az API aktiválásához a projektjéhez.

5. Az API engedélyezése után lépjen a ‘Credentials’ fülre, és kattintson a ’+ Create Credentials’ gombra. Válassza az ‘API key’ lehetőséget a legördülő menüből. Az új API kulcs létrejön és megjelenik a képernyőn.

6. Korlátozza az API kulcsát a jogosulatlan használat megakadályozásához:
   • Kattintson az ‘Edit API Key’ gombra (vagy a kulcs melletti ceruza ikonra)
   • Az ‘Application restrictions’ alatt válassza a ‘Websites’ lehetőséget
   • Adja hozzá a következő referrer domaineket az API kulcs Shopify áruházára való korlátozásához:
     • *.[MERCHANT-DOMAIN].com (cserélje ki a valós domainjére)
     • *.myshopify.com
     • [MERCHANT-DOMAIN].com (cserélje ki a valós domainjére)
     • https://shop.app
     • https://shopify.com
     • Adja hozzá az összes egyéb domaint, amelyen az áruháza működik
   • Az ‘API restrictions’ alatt válassza a ‘Restrict key’ lehetőséget, és csak a ‘Maps JavaScript API’ lehetőséget jelölje be

7. Kattintson a ‘Save’ gombra a beállítások mentéséhez.

Részletes utasításokért tekintse meg a Google hivatalos útmutatóját az API kulcs megszerzéséről.

Google Places API kulcs létrehozása

Ez a kulcs a térképen belüli cím kereséshez szükséges — az ügyfelek beírhatnak egy címet, és az autocomplete gépelés közben javaslatokat kínál. A csomagátvételi pontok ezután a megadott cím közelében jelennek meg. E kulcs nélkül a keresés működik, de autocomplete nélkül és kisebb pontossággal.

Fontos: Használjon külön API kulcsokat

Egy másik API kulcsot kell létrehoznia a Places API-hoz, a Google Maps JavaScript API kulcstól elkülönítve. A Places API kulcsot a háttérrendszerben használják, és más biztonsági korlátozásokat igényel, mint a Maps JavaScript API kulcs.

1. Ugyanazon a Google Cloud Platform Console oldalon használja ugyanazt a projektet, amelyet a Maps API-hoz hozott létre.
2. Lépjen az ‘APIs & Services’ irányítópultra, és kattintson az ‘Enable APIs and Services’ lehetőségre.
3. A keresőmezőbe írja be a Places API (New) kifejezést, és válassza ki. Ezután kattintson az ‘Enable’ gombra az API aktiválásához.

Használja a Places API (New) verziót

Győződjön meg arról, hogy a Places API (New) verziót engedélyezi, nem a régebbi Places API-t. Az új verzió jobb teljesítményt és több funkciót kínál.

4. Az API engedélyezése után lépjen a ‘Credentials’ fülre, és kattintson a ’+ Create Credentials’ gombra. Válassza az ‘API key’ lehetőséget a legördülő menüből.

5. Fontos: Adjon leíró nevet ennek a kulcsnak, például „Places API Key”, hogy megkülönböztesse a Maps JavaScript API kulcstól.

6. Korlátozza ezt az API kulcsot:

   • Kattintson az ‘Edit API Key’ gombra
   • Az ‘Application restrictions’ alatt válassza a ‘None’ lehetőséget (ez a kulcs csak szerveroldali, nem böngészőbeli használatra van)
   • Az ‘API restrictions’ alatt válassza a ‘Restrict key’ lehetőséget, és csak a ‘Places API (New)’ lehetőséget jelölje be

7. Kattintson a ‘Save’ gombra a beállítások mentéséhez.

API kulcsok hozzáadása a Globe Pickup Points alkalmazáshoz

Az API kulcsok létrehozása után integrálja azokat a Globe Pickup Points alkalmazásba:

1. Lépjen be a Shopify adminisztrációjába.
2. Lépjen a Globe Pickup Points alkalmazásba.
3. Lépjen a Beállítások oldalra.
4. Két külön mezőt talál:
   • Google Maps API kulcs (ajánlott) - Illessze be ide a Maps JavaScript API kulcsot az interaktív térkép engedélyezéséhez
   • Google Places API kulcs (opcionális) - Illessze be ide a Places API kulcsot a térképen belüli cím kereséshez autocomplete funkcióval. Nélküle a keresés működik, de kevésbé pontos és cím-kiegészítés nélkül.
5. Hozzáadhatja az egyik vagy mindkét kulcsot attól függően, hogy milyen funkciókat szeretne engedélyezni.
6. Kattintson a Mentés gombra a változtatások mentéséhez.

Az API kulcsok beállításával engedélyezi a fejlett, térképalapú csomagátvételi pont kiválasztást helymeghatározási keresési funkcióval, ami jelentősen javítja az ügyfelek élményét.

---