Активиране на Google Maps / Places
YS Board използва Places API (New) за предложения при въвеждане на адрес и потвърждаване на избраното място. Самата навигация се отваря чрез Google Maps линк с Place ID. Не са нужни Maps JavaScript API, Geocoding API или Routes API за тази реализация. Google Calendar OAuth и този API ключ са отделни настройки и могат да са в един Google Cloud проект.
1. Проектът
Отворете Google Cloud Console с акаунта на проекта. Горе изберете същия проект YS Board, в който настроихте Calendar API. Уверете се, че не е избран друг проект.
2. Billing
От ☰ → Billing свържете billing акаунт към проекта. Ако още нямате такъв, следвайте процедурата на Google за създаването му и прегледайте показаните условия и платежни данни. Това се прави лично от собственика на акаунта. Включеният billing сам по себе си не означава, че всяка заявка е платена.
Активираният billing акаунт не определя сам по себе си крайната цена. Таксуването зависи от използваните API операции, полета и действащите условия за проекта. Проверете актуалната официална ценова листа и настройте подходящи квоти/известия. Не приемайте стар пример за безплатни операции като гаранция за бъдещо таксуване.
3. Включете API
- Отворете APIs & Services → Library.
- Потърсете точно Places API (New).
- Отворете резултата и натиснете Enable. Ако пише Manage, API вече е включен.
4. Създайте ключ
- Отидете в APIs & Services → Credentials.
- Натиснете Create credentials → API key.
- Отворете настройките на създадения ключ. Дайте име, например YS Board Places Server.
- Под API restrictions изберете Restrict key, отметнете само Places API (New) и запазете.
YS Board прави заявките от сървъра. Ако задавате Application restrictions, подходящият тип е IP addresses с действителния изходящ публичен IP на сървъра/офисния рутер. Локален адрес 192.168… и домейнът на Cloudflare Worker не са изходящи IP адреси за тези заявки. При динамичен интернет адрес IP ограничението трябва да се актуализира след промяната му. Не използвайте Website/HTTP referrer ограничение за този сървърен ключ. Ако засега оставите Application restrictions на None, запазете поне ограничението само до Places API (New).
5. Поставете ключа в YS Board
- Влезте като администратор → Администраторски достъп → Календар.
- Под Google настройките има секция Google Maps / Places и Офис YS.
- Поставете ключа в Google Places API ключ и натиснете Запази ключа.
- Полето се изчиства. При следващо отваряне се вижда само, че има запазен ключ. Празно поле запазва съществуващия.
Не изпращайте ключа в чата, не го слагайте в APK или публични файлове. Той се пази шифрован в PostgreSQL settings чрез същия защитен ключ на YS Board. Не се връща в GET и не влиза в управлявания лог.
6. Настройте Офис YS
- В полето Локация на Офис YS въведете пълния адрес с града, например „София, ул. Бигла 3“.
- Изчакайте предложенията и натиснете правилното място. Самото написване не потвърждава позицията.
- Натиснете Запази локацията на офиса.
Във формата за събитие изборът „Офис YS“ използва тази запазена локация. „Онлайн“ е само обозначение и не създава Meet връзка. При собствен адрес служителят избира мястото от предложенията.
7. Проверка
Отворете „+ събитие“, започнете да пишете адрес и изберете предложение. След успешно запазване Google Calendar получава избрания адрес. YS Board пази и Place ID за точен Google Maps линк. Използването на навигацията зависи от браузъра/телефона и свързаната автомобилна система; не се инсталира отделна навигация.
8. Квоти и грешки
Следете APIs & Services → Places API (New) → Quotas/Metrics и Billing → Reports. Може да настроите бюджетни известия; те са предупреждения, а не автоматичен твърд лимит на разхода. Приложението изчаква при писане, изпраща търсене от поне 3 знака и ограничава честотата. Ползват се само нужните Essentials полета за адрес; не се заявяват снимки, оценки, ревюта или работно време.
- Отказ от Google: проверете billing, включен Places API (New), API restrictions и изходящия IP при IP ограничение.
- Няма предложения: въведете град и по-пълен адрес, проверете интернет връзката на сървъра.
- Изтекъл избор на място: изберете адреса отново. Потвърждението за формата е временно.
- Липсва Google Calendar връзка: настройте OAuth отделно; Maps ключът не замества Calendar OAuth.
Адреси и Google Maps
При търсене въведеният адрес се изпраща от сървъра към Google Places за предложения. Не се добавят YS Board име, логин или клиентски IP в заявката. Не се пазят сурови Places отговори или GPS координати в постоянен кеш. За конкретното събитие се пазят потвърденият от потребителя адрес и Place ID. Предложенията са означени с Google Maps. При ползване на услугата се прилагат условията на Google Maps и политиката за поверителност на Google; операторът на фирмената система определя достъпа на служителите до събитията.
Официални инструкции: Places API (New) setup и употреба и billing.
Хелп при миграция на YS Board
Places се извиква от сървъра с отделен ключ. При запазен изходящ IP смяната само на Board домейна обикновено не изисква промяна в Google Cloud.
- Пренесете settings и secret.key и настройте новия public_url на Board.
- При нова машина или интернет връзка проверете нейния изходящ публичен IP.
- Google Cloud Console → APIs & Services → Credentials → ключа за Places → Application restrictions → IP addresses → добавете новия изходящ адрес → Save.
- Пазете API restrictions само до Places API (New). Не използвайте Website/HTTP referrer за сървърния ключ и не въвеждайте LAN IP, клиентски IP или адреса на Cloudflare проксито вместо изходящия адрес на сървъра.
- При същия ключ не е нужно повторно въвеждане в Board. При реална смяна на ключа го запазете в Администраторски достъп → Календар → Google Maps / Places. Проверете Офис YS.
- Пробвайте адресно предложение и точния избран адрес във форма за събитие; Откажи завършва пробата без създаване/покани.
Пълното ръководство за миграция, общите Board стъпки и проверките за тази услуга.