Эта страница переведена с помощью Cloud Translation API.

Руководство по выставлению счетов для платформы Google Maps и мобильных устройств

Прежде чем запускать новый проект Google Maps в рабочую среду, необходимо убедиться в правильности настроек, чтобы платить за используемые продукты по правильной цене. В этом документе мы рассмотрим аспекты, которые помогут вам обеспечить (i) прозрачность выставления счетов — чтобы можно было проверить использование до формирования счета-фактуры, и (ii) правильную настройку проекта — чтобы вы могли использовать наши продукты.

Хотя этот процесс должен быть относительно простым, компания Maps Partners может помочь вам обеспечить правильное перемещение ваших проектов.

Концепции

В этом разделе мы хотим убедиться, что вы понимаете основную информацию о выставлении счетов Google Maps и различных возможных настройках. Во многих ситуациях нет правильного или неправильного ответа, все зависит от того, какого результата вы хотите достичь.

В этом документе мы много говорим о вашем проекте Google Cloud. Это связано с тем, что продукты Google Maps доступны через него. Это означает, что настройка, описанная в этом документе, выполняется в вашем проекте Google Cloud.

Платежные счета

Сегодня каждая компания, использующая продукты Google Maps, имеет связанный с ней проект Google Cloud. Для этого проекта необходимо настроить платежный аккаунт. Платежный аккаунт отвечает за начисление всех платежей за использование Google Maps и ежемесячное формирование счета-фактуры на основе этого использования.

Для мобильных сервисов создан специальный платежный аккаунт. Этот аккаунт предназначен для использования только в сценариях, связанных с мобильными сервисами, таких как: совместные поездки, доставка и логистика.

Один платежный аккаунт может использоваться несколькими проектами Google Cloud или только одним.

Один проект, привязанный к одному и тому же платежному аккаунту:

Конкретный сценарий использования (например, сценарии использования в сфере мобильных технологий)
Отдельные счета-фактуры
Скидка предоставляется в зависимости от объема работ по данному проекту.

Несколько проектов привязаны к одному и тому же платежному аккаунту:

Аналогичный сценарий использования
Воспользуйтесь преимуществами скидок, объединив данные об использовании.
Единый счет-фактура

Для получения дополнительной информации о платежных системах и другой соответствующей информации перейдите по этой ссылке .

Как указано выше, один платежный аккаунт может указывать на несколько проектов. Если у вас более одного проекта, вам следует определить, какие из них будут использовать наши мобильные сервисы, и указать для них отдельный платежный аккаунт для мобильных сервисов. Проекты, для которых не существует сценария использования мобильных сервисов, должны продолжать указывать на обычный платежный аккаунт Google Maps Platform, который вы используете сегодня. Для получения платежного аккаунта для мобильных сервисов необходимо заключить соглашение о мобильных услугах с Google или через партнера. Ниже вы можете увидеть, как платежный аккаунт вписывается в общую схему и какие существуют варианты его настройки:

**Возможные варианты настройки платежного аккаунта.**

Облачные ресурсы, учетные записи для выставления счетов и формирование счетов-фактур.

Что касается ценообразования, на платформе Google Maps существуют различные уровни скидок, доступные через партнеров Maps или напрямую через Google в некоторых случаях. Эти уровни зависят от объема использования, поэтому вы платите меньше, чем больше используете наши продукты (скидки применяются к каждому SKU индивидуально). Наша система выставления счетов идентифицирует ваши проекты на основе учетных данных, которые вы использовали для вызова наших продуктов; это может быть ключ API или учетная запись службы для некоторых API мобильной связи:

API-ключи

Аутентификация API платформы Google Maps осуществляется с помощью ключа API. На основе этого ключа API Google идентифицирует платежный аккаунт соответствующего проекта Google Cloud, куда будет осуществляться использование API.

Пример запроса к API геокодирования :

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY

JWT

Для некоторых API требуется идентификатор проекта Google Cloud в URL-адресе, и для аутентификации используется JWT. Поэтому важно убедиться, что соответствующие системы используют правильный метод аутентификации, чтобы обеспечить корректное выставление счетов.

Пример запроса к API Fleet Engine :

curl -X GET \ https://fleetengine.googleapis.com/v1/providers/project_id/deliveryVehicles/vehicle-1234 \
  -H 'authorization: Bearer eyJ0eXAiOi...' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
    "lastLocation": {
        "location": {
            "latitude": 37.432,
            "longitude": -122.094
        },
        "updateTime": "2022-11-13T17:55:00Z"
    }
}'

Затраты

На платформе Google Maps стоимость рассчитывается на основе объема запросов к API. Для мобильных сервисов мы взимаем плату на основе объема оплачиваемых транзакций, то есть успешно завершенных поездок или задач (доставки, а не забор грузов). Это определяется до подписания договора. Если вы занимаетесь сервисами совместных поездок или доставкой еды, то завершение поездки или доставки является вашим показателем успеха — это соответствует поездке . Задачи используются логистическими компаниями и розничными продавцами, которым необходимо успешно доставить посылки.

Мы понимаем, что клиенты Mobility также используют продукты платформы Google Maps для выполнения своих поездок и доставок. Поэтому, если вы используете учетную запись для оплаты услуг Mobility, вы можете обращаться к платформе Google Maps бесплатно при условии соблюдения заранее установленных лимитов в рамках одного и того же сценария использования Mobility.

Например, если вы занимаетесь доставкой еды, то за каждую успешно выполненную поездку вы можете десять раз обратиться к API геокодирования. Подробнее об этих ограничениях см. в разделе «Ограничения использования» в документации по мобильным технологиям. Любые изменения ограничений потребуют внесения поправок в ваш договор, поэтому обратитесь к представителю Google или партнера, чтобы обсудить ваши конкретные потребности.

В конце месяца будет выставлен счет на основе (i) количества успешно выполненных поездок или задач, зарегистрированных в системе, и (ii) объема вызовов API платформы Google Maps, превышающего установленные лимиты («превышение лимитов»). Наши лимиты соответствуют потребностям рынка, которые мы в целом наблюдаем.

Мы рекомендуем вам внимательно ознакомиться с официальной документацией по оплате услуг мобильной связи, которую можно найти здесь .

Пилотные проекты и оценка

Клиенты могут провести небольшой пилотный проект (проверка концепции, оценка) мобильных сервисов на платёжном аккаунте Google Maps Platform в течение ограниченного периода времени до подписания контракта. Если вы хотите провести пилотный проект, свяжитесь со своим партнёром по Maps или представителем Google.

Как уже упоминалось, на этапе пилотного проекта нет доступного аккаунта для оплаты мобильных услуг, поскольку договор еще не подписан. Это означает, что при использовании продуктов платформы Google Maps будет взиматься плата, но за использование специализированных мобильных продуктов плата взиматься не будет. Другими словами, на этапе пилотного проекта оплата не привязана к задачам или поездкам, и, следовательно, ограничения на использование в этот период не применяются.

После официального запуска пилотного проекта в серийное производство оплата должна производиться в соответствии с контрактом.

В заключение:

Пилотный/этап разработки : плата взимается только за общедоступные API Google Maps. За API и SDK, которые не являются общедоступными, плата не взимается до тех пор, пока в проекте не будет использоваться учетная запись для мобильной оплаты. Имейте в виду, что Google предоставляет бесплатный объем использования для каждого SKU платформы Google Maps при создании любой новой учетной записи для оплаты. Этого должно быть достаточно для контролируемой среды в течение периода оценки.
Этап производства : оплата производится либо за поездки, либо за задания. Расходы, связанные с платформой Google Maps, возникают только в том случае, если использование превышает лимиты («ограничения»), указанные в договоре. В этом случае вы будете платить за превышение лимита. Плата за превышение лимита взимается в соответствии с условиями, указанными здесь .

Как перейти на мобильный тарифный план

При миграции в производственную среду обычно требуется создать дополнительные проекты Google Cloud для представления различных сред, таких как QA (контроль качества) и производственная среда. До этого у вас, вероятно, была только одна среда — среда разработки.

Требования

Человек на вашей стороне, который может:

Управление платежными учетными записями в Google Cloud обычно осуществляется администратором платежных учетных записей или владельцем проекта.
Доступ к новому идентификатору платежного аккаунта, который был предоставлен в приветственном письме, сгенерированном после подписания договора.
Доступ к проекту Google Cloud, соответствующему производственной среде, в которой будут регистрироваться поездки или задачи.

Выполните следующие шаги, чтобы создать новые проекты и настроить выставление счетов для них.

Настройка нового проекта

Создание проекта

[Вы] Создаёте новый проект Google Cloud в консоли Google Cloud для каждой новой среды. Например, для производственной, тестовой и среды обеспечения качества.
[Партнер или команда Google] Добавьте новые проекты в список разрешенных, чтобы получить доступ к мобильным продуктам. Свяжитесь со своим торговым представителем в Google или у партнера и предоставьте идентификатор проекта, созданный на предыдущем шаге.
[Вы] Обновите важные контактные данные в своих проектах. Этот шаг очень важен для того, чтобы службы поддержки Google могли связаться с нужными людьми по вашему проекту в случае необходимости.

Конфигурация проекта

Выполните следующие действия в консоли Google Cloud для проекта, созданного на предыдущих шагах:

[Вы] Создаёте служебные учётные записи, включая привязку соответствующих ролей управления идентификацией и доступом (IAM) ( на основе поездок и задач ).
- как это делалось в среде разработки или, при необходимости, с более структурированным разделением доступа — см. этот раздел.
[Вы] Создаёте ключи API — так же, как это делалось в среде разработки, или с более структурированным разделением доступа (например, по продуктам, доменам и т. д.), если это необходимо.
[Вы] включаете API, такие как "Местные поездки и доставки", а также другие необходимые API платформы Google Maps (например, геокодирование, автозаполнение, проверка адресов).
[Ваша] квота: если вам необходимо увеличить количество запросов в минуту (QPM) для определенных API, создайте заявку в службу поддержки. Инструкции по этому поводу можно найти здесь . Необходимо добавить обоснование необходимости увеличения квоты. Предварительно установленные квоты можно посмотреть здесь .
[Вам] Если у вас есть системы, разработанные с использованием учетных данных из среды разработки, убедитесь, что эти системы могут ссылаться на новые учетные данные, созданные для новых проектов. Это включает в себя перенаправление бэкенд- и фронтенд-систем на новые учетные данные, такие как ключи API, сервисные учетные записи, а также обеспечение использования правильных идентификаторов проектов в каждой соответствующей среде.

Настройка выставления счетов

Здесь мы предполагаем, что вы уже заключили договор с Google напрямую (если применимо) или через партнера. Это необходимое условие для получения учетной записи для оплаты мобильных услуг в приветственном письме, которая будет использоваться на следующих этапах.

[Вы] Проверьте, был ли получен идентификатор учетной записи для мобильной связи в приветственном письме , которое Google отправляет по электронной почте после подписания и исполнения договора. Важно : Приветственное письмо отправляется техническим и финансовым контактным лицам, указанным в форме заказа вашего договора. Поговорите со своей проектной командой, чтобы выяснить, кто мог его получить, и попросите этого человека предоставить вам идентификатор учетной записи для мобильной связи, который представляет собой последовательность символов и цифр, разделенных дефисом.
[Вы] должны сотрудничать с Google или партнером, чтобы убедиться в наличии проверки платежных данных — это означает, что ваши системы уже корректно передают информацию о поездках или задачах в Google. Подробнее в следующем разделе.
[Вы] Настройте свои проекты Google Cloud на новый платежный аккаунт с помощью консоли Cloud Console — см. раздел «Настройка платежного аккаунта» далее в этом документе.

Более подробную информацию о выставлении счетов в целом можно найти здесь и здесь .

Проверка платежных данных

Проверка платежей важна для обеспечения корректного выставления счетов. Иногда компании случайно неправильно внедряют API, что приводит к завышению счетов или занижению отчетности.

Проверка платежных данных включает в себя следующие этапы:

Проверка наличия tripId (или taskId) в заголовке запроса к API платформы Google Maps — подробности здесь .
Проверка корректности учета поездок (или задач). Это зависит от используемого пакета мобильной связи :
- Для запуска и оптимизации или ускорения мобильности (на основе поездок) требуется интеграция с API ReportBillableEvent . Это означает, что при каждом успешном завершении поездки необходимо отправлять запрос к этому API. Чтобы проверить правильность выполнения этой операции, необходимо выполнить шаги, описанные здесь .
- Ускорение мобильности (на основе задач) : выставление счетов не обязательно должно запускаться вызовом API. Это происходит автоматически, когда результат задачи в задании доставки устанавливается как «УСПЕШНО». Поэтому очень важно правильно установить результат задачи либо как «НЕУДАЧНО», либо как «УСПЕШНО». Инженеры по работе с клиентами (партнеры или Google) будут сотрудничать с вами, чтобы убедиться в правильности реализации. С помощью Cloud Logging вы можете проверить, правильно ли обновляются задачи, выполнив следующий запрос Cloud Logging:
```
resource.type="fleetengine.googleapis.com/DeliveryFleet"
jsonPayload.@type="type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateTaskLog"
jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED"
jsonPayload.response.type="TASK_TYPE_LOG_DELIVERY"
```
Если записи отображаются, это означает, что ваши внутренние системы корректно устанавливают статус задач как «УСПЕШНО».
Примечание : важно проверить, соответствует ли количество фактически успешно выполненных поездок или задач количеству зарегистрированных звонков. Иногда мы видим, что в отчетах о платежах указываются события, не соответствующие общему количеству поездок или задач, фактически выполненных в реальной жизни (занижение данных).

Интеграция состояния здоровья

Успешная миграция в рабочую среду должна гарантировать не только корректную работу системы выставления счетов, но и бесперебойное выполнение API-интерфейсов. В случае с сервисами мобильности важно проверить правильность интеграции с Fleet Engine (API для местных поездок и доставок).

Для этого вы можете открыть Cloud Logging и использовать следующий запрос:

jsonPayload.errorResponse.code:*

В этом списке должны быть все записи журнала, содержащие сообщения о проблемах. Например:

**Запрос ошибок с использованием Cloud Logging**

Эти проблемы можно экспортировать в другие облачные продукты, такие как BigQuery. Метрики и оповещения можно настроить на основе запроса Cloud Logging:

**Создание метрик на основе запроса Cloud Logging.**

Поскольку это продукты Google Cloud, могут возникнуть дополнительные расходы. Для получения более подробной информации вы можете обратиться к своему партнеру или представителю Google.

Настройка платежного аккаунта

Если все ваши системы теперь корректно отображают поездки или задачи и нет ошибок интеграции, пришло время перенаправить ваши проекты на платежный аккаунт, который вы получили в приветственном письме и который был описан в предыдущих разделах этого документа.

Примечание : Если вы работаете с партнером Maps, он может помочь вам на этом этапе, и вам не нужно выполнять описанные ниже шаги в одиночку. Если вы работаете напрямую с Google, что может происходить в некоторых регионах, вы можете выполнить следующие шаги:

Для этого:

Откройте консоль Google Cloud (https://console.cloud.google.com).
Выберите новый проект, который будет использоваться в производственной среде.
Перейдите в раздел «Биллинг» этого проекта. Для быстрого доступа можно использовать следующую ссылку: https://console.cloud.google.com/billing
Оплата > Нажмите «Управление платежными учетными записями»:

Ваш проект может выглядеть иначе, чем показано выше.
В разделе «Оплата» > Нажмите на значок с тремя точками. Рядом с созданным производственным проектом выберите «Изменить платежный счет»:
В разделе «Оплата» > в настройках учетной записи выберите в выпадающем списке код учетной записи, полученный в приветственном письме. Затем нажмите «УСТАНОВИТЬ УЧЕТНУЮ ЗАПИСЬ»:
Проект будет привязан к новому платежному аккаунту:

Важно : С этого момента все поездки или задачи, указанные в этом проекте, будут оплачиваться, как описано ранее. Если подтверждение платежа еще не произошло, не привязывайте платежный аккаунт.
После добавления нового способа оплаты перейдите в раздел «Обзор > Обзор платежей» и «Настройки платежей», чтобы убедиться в правильности информации. Для получения дополнительной информации об обновлении данных о выставлении счетов и платежах, пожалуйста, перейдите по этой ссылке . По любым вопросам, связанным с выставлением счетов, пожалуйста, создайте заявку в службу поддержки по вопросам выставления счетов или обратитесь к своему партнеру или представителю Google.

Отчеты по выставлению счетов

Отчеты по выставлению счетов помогают понять затраты, связанные с платежным счетом, привязанным к проекту.

Примечание : Если вы работаете с партнером Maps, пожалуйста, свяжитесь с ним, чтобы убедиться, что вам предоставлена вся необходимая платежная информация.

Откройте связанный с проектом платежный аккаунт, выберите «Отчеты». Затем вы можете использовать следующий набор фильтров:

**Фильтры отчета по выставлению счетов**

Здесь основная настройка, которую следует учитывать, — это фильтр «Группировать по SKU», который отобразит подробную информацию о поездках и задачах, а также о других API, если они используются, включая информацию о наличии или отсутствии перерасходов, как объяснялось ранее:

Информация в отчете обновляется ежедневно. Если необходима информация за день, можно использовать запросы Cloud Logging, чтобы узнать, сколько событий, подлежащих оплате, произошло за день. Подробнее об этом см. в предыдущих разделах.

План поэтапного наращивания темпов

Важный момент, который следует упомянуть, — это ваш план поэтапного внедрения. Не всегда весь трафик переводится на мобильный проект, в зависимости от специфики вашего бизнеса. Например, некоторым компаниям требуется время для внедрения нового решения во всех своих филиалах, франшизах, магазинах, офисах и т. д., а это значит, что часть трафика будет использовать старые системы, а часть — новый проект.

Кроме того, во многих случаях не весь трафик будет относиться к сценариям использования мобильных устройств, как, например, в случае с поиском магазинов, доставкой заказов к автомобилю и другими внутренними решениями. В таких случаях следует указывать на платежный аккаунт Google Maps Platform, поскольку трафик из этого аккаунта должен храниться отдельно от трафика из мобильного аккаунта.

Важно соблюдать Политику внедрения:

Модель, основанная на количестве поездок : «Решение для заказа поездок и доставки по требованию предназначено для использования в коммерческих службах заказа поездок и доставки по требованию. Такие услуги обычно включают в себя (а) потребителей, которые отправляют запросы на поездку в определенное место назначения (или доставку конкретного товара), и (б) водителей, которые подбираются под запросы и управляют транспортным средством для выполнения услуг».
Модель, основанная на задачах : «Решение Google Maps Platform Last Mile Fleet предназначено для использования в коммерческих услугах доставки «последней мили» и доставки «первой мили». Такие услуги обычно включают в себя (а) парк транспортных средств доставки, принадлежащих заказчику или находящихся у него в аренде, (б) доставку по заранее спланированному маршруту, (в) сеть распределительных центров с оперативными группами, поддерживающими выполнение доставки, и (г) потребителей, которые отслеживают и затем получают отправления».

Поэтому вам следует понимать, какие из ваших систем должны указывать на платежный аккаунт платформы Google Maps, а какие — на платежный аккаунт мобильной связи. Нередко бывает несколько проектов, и каждый из них указывает на правильный платежный аккаунт.

Например, предположим, что каждая поездка/задача сегодня включает 10 запросов геокодирования в соответствии с лимитами использования. Если миграция займет несколько месяцев, и вы начнете обрабатывать 100 000 поездок/задач в первый месяц, это означает, что вы можете вызвать API геокодирования 1 миллион раз. Но если ваш бизнес обработает 5 миллионов запросов геокодирования, эта разница (4 миллиона) может быть учтена как превышение лимита. Здесь возможны два варианта:

Вы увеличиваете количество поездок/заданий, о которых сообщаете нам (ускоряете план наращивания объемов), поэтому применяются более высокие лимиты, в данном случае вам потребуется сообщать о 500 000 поездках/заданиях в месяц.
Как объяснялось ранее, в ходе переговоров по контракту вы договариваетесь о более высоких лимитах.
Вы перенаправляете запросы к API геокодирования на API платформы Google Maps, чтобы воспользоваться более высокими уровнями скидок и платить меньше, чем за превышение лимита.

Мы понимаем, что оценка затрат, в зависимости от размера и сложности вашего бизнеса и сценариев использования, может быть сложной задачей. Пожалуйста, сотрудничайте со своим партнером или представителем Google, чтобы определить наилучший способ подготовки к запуску в производство с использованием ваших существующих проектов.

Вкратце, для создания надлежащего плана внедрения необходимы следующие шаги: 1. Определить, какие сценарии использования связаны с мобильностью, а какие нет, в соответствии с политикой внедрения. 2. Определить, какие API платформы Google Maps используются сегодня для соответствующих сценариев использования и в каком объеме. 3. Определить, потребуются ли API платформы Google Maps после внедрения решения для мобильности — например, расчет времени прибытия происходит автоматически в Fleet Engine, и вам, возможно, больше не потребуется рассчитывать его с помощью API Directions. 4. Определить, сколько времени потребуется для полной миграции сценариев использования мобильности на новую платформу мобильности на вашей стороне. 5. Дважды проверить, достаточно ли лимитов использования для поддержки ваших сценариев использования. 6. Определить переломный момент, когда все запросы к платформе Google Maps могут быть перенесены в учетную запись для оплаты услуг мобильности для соответствующих сценариев использования.

Заключение

В заключение, правильная настройка платежного аккаунта имеет важное значение для предсказуемости цен и прозрачности. Используя наши мобильные технологии, включающие лучшие в своем классе геолокационные сервисы, компании могут быть уверены в точности и эффективности своих процессов выставления счетов. Это не только помогает снизить затраты, но и предоставляет необходимые данные и аналитические выводы для принятия обоснованных бизнес-решений. Более того, прозрачность, обеспечиваемая такой системой, позволяет компаниям четко понимать свои расходы, что приводит к более эффективному управлению бюджетом.

Следующие действия

Настройте свой платежный аккаунт в консоли Google Cloud.
Более подробную информацию о выставлении счетов в целом можно найти по адресу:
- Коммерческая документация по услугам мобильности
- Включить, отключить или изменить выставление счетов для закладки проекта bookmark_border .