← YS Board

Активиране на Google Maps / Places

Хелп при миграция на YS Board

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

  1. Отворете APIs & Services → Library.
  2. Потърсете точно Places API (New).
  3. Отворете резултата и натиснете Enable. Ако пише Manage, API вече е включен.

4. Създайте ключ

  1. Отидете в APIs & Services → Credentials.
  2. Натиснете Create credentials → API key.
  3. Отворете настройките на създадения ключ. Дайте име, например YS Board Places Server.
  4. Под 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

  1. Влезте като администратор → Администраторски достъп → Календар.
  2. Под Google настройките има секция Google Maps / Places и Офис YS.
  3. Поставете ключа в Google Places API ключ и натиснете Запази ключа.
  4. Полето се изчиства. При следващо отваряне се вижда само, че има запазен ключ. Празно поле запазва съществуващия.

Не изпращайте ключа в чата, не го слагайте в APK или публични файлове. Той се пази шифрован в PostgreSQL settings чрез същия защитен ключ на YS Board. Не се връща в GET и не влиза в управлявания лог.

6. Настройте Офис YS

  1. В полето Локация на Офис YS въведете пълния адрес с града, например „София, ул. Бигла 3“.
  2. Изчакайте предложенията и натиснете правилното място. Самото написване не потвърждава позицията.
  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 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.

  1. Пренесете settings и secret.key и настройте новия public_url на Board.
  2. При нова машина или интернет връзка проверете нейния изходящ публичен IP.
  3. Google Cloud Console → APIs & Services → Credentials → ключа за Places → Application restrictions → IP addresses → добавете новия изходящ адрес → Save.
  4. Пазете API restrictions само до Places API (New). Не използвайте Website/HTTP referrer за сървърния ключ и не въвеждайте LAN IP, клиентски IP или адреса на Cloudflare проксито вместо изходящия адрес на сървъра.
  5. При същия ключ не е нужно повторно въвеждане в Board. При реална смяна на ключа го запазете в Администраторски достъп → Календар → Google Maps / Places. Проверете Офис YS.
  6. Пробвайте адресно предложение и точния избран адрес във форма за събитие; Откажи завършва пробата без създаване/покани.

Пълното ръководство за миграция, общите Board стъпки и проверките за тази услуга.