Google Maps и геокодирование

Чтобы использовать Google Maps с Navixy On-premise, вам необходимо получить действительные ключи API Google Maps. Эта страница документации содержит пошаговое руководство по созданию ключей API Google Maps и их настройке для использования с платформой Navixy.

Руководство проведёт вас через процесс настройки учётной записи Google Cloud Console, создания нового проекта, генерации необходимых ключей API и применения их в конфигурации вашей инстанции Navixy. Следуя этому руководству, вы сможете легко интегрировать Google Maps с Navixy On-premise и полностью воспользоваться продвинутыми возможностями карт платформы.

Создание Google API-ключей

Чтобы создать Google API-ключи для использования с платформой Navixy, выполните приведённое ниже руководство. Обратите внимание, что ключи Google API связаны с вашей учётной записью и подпадают под политику использования API Google. Для дополнительной информации обратитесь к ссылкам ниже:

• Условия использования Google Maps APIs

• Часто задаваемые вопросы о Google Maps

Настройка учётной записи и проекта

1. Перейдите на Google Cloud Console веб-страницу и войдите, используя учётные данные вашей Google-учётной записи. Если у вас нет учётной записи, вы можете создать её.

2. Ключи API создаются внутри проекта. Если у вас уже есть проект, вы можете выбрать его из списка. Если у вас нет существующих проектов, нажмите «Create project», чтобы создать новый.

3. Дайте проекту соответствующее имя и нажмите кнопку «Create», чтобы создать новый проект

1. Убедитесь, что выбран ваш вновь созданный проект, и нажмите «Enable APIs and Services». Вы перейдёте в библиотеку Google API.

2. Введите название требуемого API, выберите его и нажмите «Enable». В данном случае мы добавляем Maps Javascript API (используется для Google Maps)

3. Повторите процесс для всех необходимых API. Navixy использует в общей сложности 5 API:

• Google Maps JavaScript API - карты Google в пользовательском интерфейсе

• Google Maps Geocoding API - геокодирование

• Google Maps Geolocation API - обработка LBS-точек

• Google Maps Directions API - построение маршрутов

• Google Static Maps API - статические карты в электронной почте

Убедитесь, что все включённые API отображаются на вашей панели:

Генерация Google-ключей

Чтобы включить весь функционал Navixy, вам потребуется всего три ключа API:

• Ключ №1 для отображения карт в пользовательском интерфейсе

• Ключ №2 для доступа к GIS-сервисам (геокодирование, построение маршрутов и геолокация)

• Ключ №3 для отображения статических Google Maps в уведомлениях по email

Генерация Google-ключа №1 для карт в UI

1. Перейдите в Credentials вкладку

2. Нажмите Create credentials и выберите API key

3. Ключ будет показан в новом окне

4. Нажмите Restrict key чтобы внести изменения, вы будете перенаправлены на страницу настройки

5. Дайте ключу имя, чтобы было проще отличать его от других

6. В Application restrictions выберите HTTP referrer и укажите домен, который вы используете для платформы. Например contoso.com/* gps.contoso.com/*

7. В API restrictions выберите Restrict key и выберите Maps JavaScript API

8. Нажмите Save чтобы применить изменения

Генерация Google-ключа №2 для геокодирования, построения маршрутов и геолокации

1. Перейдите в Credentials вкладку

2. Нажмите Create credentials и выберите API key

3. Ключ будет показан в новом окне

4. Нажмите Restrict key чтобы внести изменения, вы будете перенаправлены на страницу настройки

5. Дайте ключу имя, чтобы было проще отличать его от других

6. В Application restrictions выберите IP adresses и укажите публичный IP вашего сервера

7. В API restrictions выберите Restrict key и выберите Maps Geocoding API, Maps Geolocation API, Maps Directions API

8. Нажмите Save чтобы применить изменения

Генерация Google-ключа №3 для статических карт в уведомлениях по email

1. Перейдите в Credentials вкладку

2. Нажмите Create credentials и выберите API key

3. Ключ будет показан в новом окне

4. Нажмите Restrict key чтобы внести изменения, вы будете перенаправлены на страницу настройки

5. Дайте ключу имя, чтобы было проще отличать его от других

6. В Application restrictions выберите HTTP referrer и укажите домен, который вы используете для платформы. Например contoso.com/* gps.contoso.com/*

7. В API restrictions выберите Restrict key и выберите Maps Static API

8. Нажмите Save чтобы применить изменения

Для Google-ключа №3 вам также потребуется URL signing secret. Пожалуйста, обратитесь к приведённому ниже руководству, чтобы сгенерировать URL signing secret для вашего ключа Static maps:

1. Перейдите в Dashboard

2. Прокрутите вниз до списка API и кликните на Maps Static API

3. Вы будете перенаправлены на новую страницу.

4. Нажмите на Credentials menu

5. Проверьте, что выбран Maps Static API

6. Прокрутите вниз до URL signing secret, чтобы увидеть текущий ключ.

Применение Google Maps API-ключей

Как описано выше, мы рекомендуем сгенерировать три ключа Google Maps и назначить для них следующие сервисы Google API:

Google Maps API ключ №1 – должен быть ограничен по HTTP referrer, то есть URL вашего пользовательского интерфейса:

• Google Maps JavaScript API

• Google Street View Image API

Google Maps API ключ №2 – должен быть ограничен по IP сервера:

• Google Maps Geocoding API

• Google Maps Geolocation API

• Google Maps Directions API

Google Maps API ключ №3 – должен быть ограничен по HTTP referrer, то есть URL вашего пользовательского интерфейса:

• Google Static Maps API (для этого ключа вам также нужен URL signing secret )

Все три ключа будут сохранены в базе данных. Их следует вставить в таблицу dealer_service_credentials в google БД с помощью следующего запроса:

INSERT INTO dealer_service_credentials (dealer_id, service_type,credentials) VALUES (1, 'google', '{"maps_js_api_key":"FIRST_KEY_HERE","server_api_key":"SECOND_KEY_HERE","static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}';

Если вы не хотите использовать Google Maps для определённых сервисов, вы можете опустить ключи, которые вам не нужны, из запроса. Например, используйте этот запрос, чтобы применить только третий ключ:

INSERT INTO google.dealer_service_credentials (dealer_id, service_type, credentials) VALUES (1, "google", '{"static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}');

Перезапустите сервисы

restart-navixy