Google Maps е услуга предоставяна от Google Cloud. От 2018 година насам тя е платена, но всеки потребител, който иска да я използва получава кредит в размер на 200$ всеки месец от Google. Тази сума в повечето случаи е напълно достатъчна, за да ползвате услугата, така че тя на практика е безплатна.
С Google Maps вие ще предоставите на клиентите си възможност за бърз и удобен checkout. С функционалността Google Autocomplete те ще могат да завършат поръчките си лесно и бързо. Aвтоматичното въвеждане на адреса на клиента намалява времето за попълване на полетата при завършване на поръчка и елиминира вероятността от грешно изписване на адреса. Полетата за държава, град, област, пощенски код и др. биват автоматично попълвани от Google.
В тази статия ще намерите:
- Първи стъпки
- Създаване на проект
- Генериране на API ключ
- Защити своя API ключ
- Настройки в административния панел на CloudCart магазина ви
- Създаване на бюджет
- Мониторинг на потреблението
- Troubleshooting
- Заяви услугата
Във видеото по-долу, както и в самата статия ще разберете как да свържете магазина си с Google Maps чрез API ключ, за да предостоставите отлично потребителско преживяване на клиентите си и да оптимизирате процеса по изготвянето на товарителници.
Първи стъпки
1. За да свържете CloudCart магазина си с Google Maps е необходимо да създадете свои API ключ, това става в конзолата на Google. За да влезете в нея е нужно да имате Google акаунт или, ако нямате такъв да си създадете. След като сте влезнали в профила си, отидете на адрес https://cloud.google.com/ и влезте в конзолата от бутона Console разположен в горния десен ъгъл на екрана.
2. Следващото нещо, което трябва да направите е да въведете необходимата информация в Billing accounta си от менюто разположено в ляво на екрана > Billing, за да може да ползвате услугата Google Maps и да получите първоначалния кредит от 300$. Имате на разположение 90 дни, в които да изразходите тези 300$ за услуги на Google. След което, както споменахме по-горе платформата на Google Maps предоставя на всеки потребител кредит в размер на 200$ всеки месец.
След като успешно сте въвели вашите данни ще получите съобщение за добавените от Google кредити, които са на ваше разположение за използване на услугите.
Създаване на проект
1. След като сте извършили основните действия е време да преминем към създаването на проект. По подразбиране всеки новорегистриран потребител има създаден проект, но вие може да си направите нов, в който да си настроите вашия Google Maps API ключ от бутона New Project.
2. Попълнете полетата: име на проекта, изберете вашата организация и нейната локация и натиснете бутона Create, за да създадете своя проект.
3. В долната част на навигационното меню изберете Google Maps Platform > Overview и селектирайте проекта, който вече сте създали, ако имате повече от един, в противен случай той ще ви се отвори веднага.
Тук ще трябва да активирате няколко API-та:
- Geolocation API - служи за локализиране спрямо точката, на която се намира дадения потребител.
- Places API - служи за търсене на места в Google Maps, например при изписване името на дадена организация или обект, Google връща точния адрес, на който се намира.
- Mapa JavaScript API - това е същинската библиотека на Google Maps, която задължително трябва да се ползва.
- Geocoding API - служи за конвертиране на адреси в координати. Координатите са необходими, когато се подават такива към трети услуги.
- Ако искате да ползвате и да бъде видима и в административния панел на магазина ви, статична снимка на картата, активирайте и API-то Maps Static API.
Това са 5-те API-та, които са ви необходими. За да активирате всяко едно API кликнете на него и натиснете Enable.
За да се върнете обратно и да активирате и останалите, натиснете APIs от навигационното меню.
Оттук можете да активирате и останалите API-та като кликнете на тях и отново натиснете бутона Enable.
Генериране на API ключ
1. След като вече сте активирали всички необходими API-та трябва да създадете вашия API ключ. За целта отидете на Google Maps Platform от менюто, секция Credentials и изберете APIs & Services.
2. Натиснете бутона + Create Credentials > API Key и копирайте генерирания ключ. Запазете го на отделен файл, за да може да го ползвате по-късно.
Защити своя API ключ
Препоръчваме ви да защитите вашия API ключ, защото в противен случай той ще бъде видим и лесно може да бъде откраднат от недоброжелатели, които да злоупотребят и натрупат голяма сметка на вашия акаунт. Когато ключът не е защитен ще виждате тази икона:
1. За да го защитите позиционирайте курсора на мишката върху знака за незащитен ключ и изберете edit settings.
2. Може да промените неговото име (например с името на магазина си), да зададете различни рестрикции. Ние лично препоръчваме те да бъдат по адрес на уеб сайт, за целта изберете HTTP referrers (web sites) и въведете вашия сайт в полето New Item и натиснете бутона Done.
3. В API restrictions полето може да защитите вашия ключ и по определени услуги. За целта избройте петте API-та, които активирахте по-рано (Geolocation API, Places API, Mapa JavaScript API, Geocoding API, Maps Static API) от падащото меню.
Защитеният ключ ще изглежда така:
След като сте завършили настройките си трябва да отидете в админ панела на магазина си и да поставите API ключа, за да свържете Google Maps.
Настройки в административния панел на CloudCart магазина ви
Преди да започнете с настройките в админ панела си е необходимо да изчакате известно време (обикновено около 5-10 минути), за да бъде активирана услугата от страна на Google, в противен случай ще получите съобщение за грешка.
1. За да поставите вашия API ключ в магазина си, отидете в секция Настройки > Настройки на количка. В отворилия ви се прозорец отидете на секция Други и в полето Google Maps API ключ поставете своя ключ и натиснете бутона Запази, в горния десен ъгъл на екрана.
2. За да се уверите, че всичко работи коректно отидете в магазина си, изберете продукт и го добавете в количката. Продължете към плащане и в checkout-a, изберете добавяне на адрес. Ако всичко е наред ще виждате картата на Google и подсказки за адреси при въвеждане на адрес. Всички полета ще бъдат попълнени автоматично, при въвеждане на адрес или натискане на бутона за локализиране на устройството.
Вашият ключ е активиран, както и възможностите, които имате със създаването на Гео зони и Гео полигони.
Ако някои все пак успее да открадне API ключа ви и се опита да го ползва с друг домейн, различен от този, който сте въвели в Google конзолата, системата ще засече това и ще изпише съобщение за грешка:
Създаване на бюджет
За да не бъдете таксувани от Google за тази услуга, може да си създадете бюджет на стойност равна на безплатните кредити , които получавате от Google всеки месец. Освен това може да настроите и известяване/ аларми при достигане на конкретни суми.
1. За да направите това влезте в своя акаунт и отворете Google конзолата. От навигационното меню изберете Billing > My Billing account > Budget & Alerts.
2. В полето Target Amount въведете стойността на бюджета, който искате да създадете. В нашия случай това са 200$.
3. На следващата стъпка настроите известяването при достигане на определен процент от бюджета:
Мониторинг на потреблението
От конзолата на Google, секция Google Maps Platform >Metrics може да следите потреблението на сайта ви спрямо Google Maps. Имате на разположение различни метрики и опции за филтриране според различните API-та.
В Overview е информацията за това как се движите с използването на APIs, които сте активирали:
Това е всички необходимо, за да свържете магазина си с Google Maps с помощта на API ключ, за да улесните клиентите при завършване на поръчките си.
Troubleshooting
Ако по някаква причина API ключът Ви е невалиден в чекаута при опит за завършване на поръчката клиентите Ви ще видят "счупена" карта и няма да могат да завършат поръчката си . В този случай ще получите автоматично известие в админ панела на магазина си за наличния проблем.
Заяви услугата
Ако имате нужда от съдействие за настройките на Google Maps, може да заявите услугата от бутона по-долу. Нашият екип ще извърши всички необходими действия по настройването и безпроблемно функциониране на Google Maps в CloudCart магазина ви.