이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Maps Platform 및 Mobility 결제 가이드

프로덕션에 새 Google 지도 프로젝트를 구현하기 전에 사용하는 제품에 대해 올바른 금액을 지불할 수 있도록 설정이 올바른지 확인해야 합니다. 이 문서에서는 (i) 청구 투명성(인보이스가 생성되기 전에 사용량을 확인할 수 있음)과 (ii) 올바른 프로젝트 설정(Google 제품을 사용할 수 있음)을 보장하기 위한 측면을 다룹니다.

이 과정은 비교적 간단하지만 지도 파트너와 협력하여 프로젝트가 올바르게 이동되도록 할 수 있습니다.

개념

이 섹션에서는 Google 지도 결제 및 다양한 설정에 관한 기본 정보를 이해할 수 있도록 설명합니다. 많은 상황에서 옳고 그름은 없으며, 달성하려는 결과의 유형에 따라 달라집니다.

이 문서에서는 Google Cloud 프로젝트에 대해 많이 설명합니다. Google 지도 제품을 통해 사용할 수 있기 때문입니다. 즉, 이 문서에서 다루는 구성은 Google Cloud 프로젝트에서 이루어집니다.

결제 계정

현재 Google 지도 제품을 사용하는 모든 회사에는 연결된 Google Cloud 프로젝트가 있습니다. 이 프로젝트에 결제 계정이 구성되어 있어야 합니다. 결제 계정은 모든 Google 지도 사용량을 누적하고 해당 사용량을 기준으로 매월 인보이스를 생성합니다.

Mobility의 경우 특별 결제 계정이 프로비저닝됩니다. 이 결제 계정은 차량 공유, 배송, 물류와 같은 모빌리티 관련 사용 사례에만 사용해야 합니다.

하나의 결제 계정을 여러 Google Cloud 프로젝트에서 사용할 수도 있고 하나의 프로젝트에서만 사용할 수도 있습니다.

동일한 결제 계정을 가리키는 단일 프로젝트:

구체적인 사용 사례 (예: 모빌리티 사용 사례)
별도의 인보이스
할인은 이 단일 프로젝트의 볼륨을 기준으로 적용됩니다.

동일한 결제 계정을 가리키는 여러 프로젝트:

동일한 사용 사례
사용량을 집계하여 할인 등급 활용
단일 인보이스

결제 계정 및 기타 관련 정보에 대한 자세한 내용은 이 링크를 참고하세요.

위에서 설명한 것처럼 하나의 결제 계정은 여러 프로젝트를 가리킬 수 있습니다. 프로젝트가 두 개 이상인 경우 Google 모빌리티 서비스를 사용할 프로젝트를 식별하고 모빌리티 결제 계정을 지정해야 합니다. 이동성 사용 사례가 연결되지 않은 프로젝트는 현재 사용 중인 일반 Google Maps Platform 결제 계정을 계속 가리켜야 합니다. 모빌리티 결제 계정을 받으려면 Google 또는 파트너를 통해 모빌리티 계약을 체결해야 합니다. 아래에서 결제 계정이 전체 스키마와 다양한 가능한 설정에 어떻게 적합한지 확인할 수 있습니다.

클라우드 리소스, 결제 계정, 인보이스 생성

가격에 관해 말씀드리면 Google Maps Platform에는 다양한 할인 등급이 있으며, 지도 파트너를 통해 또는 일부 시나리오에서는 Google을 통해 직접 이용할 수 있습니다. 이러한 등급은 사용량에 따라 결정되므로 제품을 많이 사용할수록 비용이 절감됩니다 (할인은 각 SKU에 개별적으로 적용됨). Google 결제 시스템은 Google 제품을 호출하는 데 사용한 사용자 인증 정보(일부 모빌리티 API의 경우 API 키 또는 서비스 계정)를 기반으로 프로젝트를 식별합니다.

API 키

Google Maps Platform API는 API 키를 사용하여 인증됩니다. Google은 이 API 키를 기반으로 소비가 발생하는 해당 Google Cloud 프로젝트의 결제 계정을 식별합니다.

Geocoding API에 대한 요청의 예:

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

JWT

일부 API는 URL에 Google Cloud 프로젝트 ID가 필요하며 JWT를 사용하여 인증합니다. 따라서 올바른 시스템에서 올바른 인증 방법을 사용하여 청구가 올바르게 이루어지도록 하는 것이 중요합니다.

Fleet Engine API 요청의 예:

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 Platform에서는 API 요청 수를 기준으로 비용이 계산됩니다. 모빌리티 서비스의 경우 청구 가능한 모빌리티 거래량(성공적으로 완료된 이동 또는 작업(배송, 수령 아님))을 기준으로 요금이 청구됩니다. 이는 계약 체결 전에 정의됩니다. 차량 공유 또는 음식 배달 회사의 경우 탑승 또는 배달 완료가 성공 지표입니다. 이는 이동에 매핑됩니다. 작업은 택배를 성공적으로 배송해야 하는 물류 회사와 소매업체에 사용됩니다.

모빌리티 고객은 여행 및 배송을 실행할 때 Google Maps Platform 제품도 사용합니다. 따라서 모빌리티 결제 계정을 사용하는 경우 동일한 모빌리티 사용 사례 내에서 사전 정의된 한도를 준수하는 한 Google Maps Platform을 무료로 호출할 수 있습니다.

예를 들어 음식 배달 회사의 경우 성공한 이동마다 Geocoding API를 10번 호출할 수 있습니다. 이러한 한도에 대해 자세히 알아보려면 모빌리티 문서의 사용량 한도를 참고하세요. 한도를 변경하려면 계약을 수정해야 하므로 Google 또는 파트너 담당자와 협력하여 구체적인 요구사항을 논의하세요.

월말에 (i) 시스템에 보고된 성공한 이동 또는 작업 수와 (ii) 사전 설정된 한도를 초과하는 Google Maps Platform API 호출 수('초과분')를 기준으로 인보이스가 생성됩니다. Google의 한도는 시장에서 필요한 것으로 널리 알려진 사항에 맞춰 조정됩니다.

여기에서 공식 모빌리티 청구 문서를 자세히 읽어보시기 바랍니다.

파일럿 및 평가

고객은 계약을 체결하기 전에 제한된 기간 동안 Google Maps Platform 결제 계정에서 모빌리티 서비스의 소규모 파일럿 (개념 증명, 평가)을 실행할 수 있습니다. 파일럿을 실행하려면 지도 파트너 또는 Google 담당자에게 문의하세요.

파일럿 단계에서는 계약이 아직 체결되지 않았으므로 모빌리티 결제 계정을 사용할 수 없습니다. 즉, Google Maps Platform 제품을 사용할 때마다 요금이 청구되지만 모빌리티 관련 제품에는 요금이 청구되지 않습니다. 즉, 파일럿 단계에서는 청구가 작업 또는 여정을 기반으로 하지 않으므로 이 단계에서는 사용량 한도가 적용되지 않습니다.

파일럿이 프로덕션에 공식적으로 출시되면 계약에 따라 비용을 지불해야 합니다.

요약

파일럿 / 개발 단계: 공개적으로 사용 가능한 Google 지도 API에 대해서만 요금이 청구됩니다. 공개적으로 제공되지 않는 API 및 SDK는 프로젝트에서 모빌리티 결제 계정을 사용할 때까지 요금이 청구되지 않습니다. Google에서는 생성된 모든 새 결제 계정에 대해 Google Maps Platform SKU별로 무료 사용량을 제공합니다. 평가 기간 동안 통제된 환경에서 사용하기에 충분합니다.
프로덕션 단계: 이동 또는 작업별로 요금이 청구됩니다. Google Maps Platform과 관련된 비용은 사용량이 계약의 사용 한도('상한')를 초과하는 경우에만 발생합니다. 이 경우 초과 요금을 지불해야 합니다. 초과분은 여기에 정의된 대로 청구됩니다.

모빌리티 결제 계정으로 이전하는 방법

프로덕션으로 이전할 때는 일반적으로 QA(품질 보증) 및 프로덕션과 같은 다양한 환경을 나타내는 추가 Google Cloud 프로젝트를 만들어야 합니다. 그전에는 개발 환경이라는 단일 환경만 있었을 것입니다.

요구사항

다음 작업을 할 수 있는 담당자

Google Cloud에서 결제 계정을 관리합니다. 일반적으로 결제 계정 관리자 또는 프로젝트 소유자가 이 작업을 실행합니다.
계약 서명 후 생성된 시작 안내에 포함된 새 결제 계정 ID에 대한 액세스 권한
여행 또는 작업이 보고될 프로덕션 환경에 해당하는 Google Cloud 프로젝트에 대한 액세스 권한

다음 단계에 따라 새 프로젝트를 설정하고 결제를 구성합니다.

새 프로젝트 설정

프로젝트 생성

[사용자] 새 환경마다 Google Cloud 콘솔에서 새 GCP 프로젝트를 만듭니다. 예를 들어 프로덕션, 스테이징, 품질 보증이 있습니다.
[파트너 또는 Google팀] 모빌리티 제품에 액세스할 수 있도록 허용 목록에 새 프로젝트를 추가합니다. Google 또는 파트너의 영업 담당자와 협력하여 이전 단계에서 만든 프로젝트 ID를 제공합니다.
[나] 프로젝트의 필수 연락처를 업데이트합니다. 이 단계는 필요한 경우 Google 지원팀이 프로젝트의 올바른 담당자에게 연락할 수 있도록 하는 데 매우 중요합니다.

프로젝트 구성

이전 단계에서 만든 프로젝트에 대해 Google Cloud 콘솔에서 다음 단계를 완료합니다.

[귀하] 올바른 모빌리티 식별 및 액세스 관리 (IAM) 역할 (여행 기반 및 작업 기반)의 연결을 포함하여 서비스 계정을 만듭니다.
- 개발 환경에서 수행한 것과 동일한 방식으로 또는 필요한 경우 액세스를 더 구조적으로 분리하여 수행합니다(이 섹션 참고).
[귀하] 개발 환경에서와 같이 또는 필요한 경우 액세스를 더 구조적으로 분리 (예: 제품별, 도메인별 등)하여 API 키를 만듭니다.
[귀하] '지역 차량 및 배송'과 필요한 기타 Google Maps Platform API (예: 지오코딩, 자동 완성, 주소 유효성 검사)를 사용 설정합니다.
[귀하] 할당량: 특정 API의 QPM (분당 쿼리 수)이 늘어나야 하는 경우 지원팀에 티켓을 제출하세요. 방법은 여기를 참고하세요. 인상된 가격이 필요한 이유를 설명하는 비즈니스 근거를 추가해야 합니다. 사전 정의된 할당량은 여기에서 확인할 수 있습니다.
[귀하] 개발 환경의 사용자 인증 정보를 사용하는 시스템을 개발한 경우 이러한 시스템이 새로 생성된 프로젝트에 대해 생성된 새 사용자 인증 정보를 가리킬 수 있는지 확인합니다. 여기에는 백엔드 및 프런트엔드 시스템을 API 키, 서비스 계정과 같은 새 사용자 인증 정보로 연결하고 각 환경에서 올바른 프로젝트 ID가 사용되는지 확인하는 작업이 포함됩니다.

결제 구성

여기서는 Google과 직접 계약을 체결했거나 (해당하는 경우) 파트너를 통해 계약을 체결했다고 가정합니다. 이는 다음 단계에서 사용할 웰컴 레터에서 모빌리티 결제 계정을 받기 위한 필수 요건입니다.

[사용자] 계약이 체결되고 실행된 후 Google에서 이메일로 전송되는 환영 메일의 일부로 모빌리티 결제 계정 ID가 수신되었는지 확인합니다. 중요: 환영 편지는 계약의 주문 양식에 지정된 기술 및 재무 담당자에게 전송됩니다. 프로젝트 팀과 협력하여 누가 이메일을 받았는지 파악하고, 해당 사용자에게 하이픈으로 구분된 일련의 문자와 숫자인 결제 계정 ID를 제공해 달라고 요청하세요.
[귀하] Google 또는 파트너와 협력하여 결제 유효성 검사를 수행합니다. 즉, 시스템에서 이미 Google에 이동 또는 작업을 올바르게 보고하고 있습니다. 자세한 내용은 다음 섹션을 참고하세요.
[귀하] Cloud 콘솔을 사용하여 Google Cloud 프로젝트를 새 결제 계정으로 지정합니다. 이 문서의 결제 계정 구성 섹션을 참고하세요.

일반적인 청구에 대한 자세한 내용은 여기와 여기에서 확인하세요.

결제 유효성 검사

결제 유효성 검사는 요금이 올바르게 청구되도록 하는 데 중요합니다. 기업이 실수로 API를 잘못 구현하여 요금이 더 많이 청구되거나 보고가 누락되는 경우가 있습니다.

결제 유효성 검사는 다음 단계로 구성됩니다.

Google Maps Platform API에 대한 요청에 요청 헤더에 tripId (또는 taskId)가 있는지 확인합니다. 자세한 내용은 여기를 참고하세요.
이동 (또는 작업)이 올바르게 보고되는지 확인합니다. 이는 사용 중인 모빌리티 패키지에 따라 다릅니다.
- Mobility Starter 및 Optimize 또는 Accelerate (이동 기반): ReportBillableEvent API와의 통합이 필요합니다. 즉, 이동이 성공적으로 완료될 때마다 이 API에 대한 요청이 이루어져야 합니다. 이 작업이 올바르게 실행되는지 확인하려면 여기에 설명된 단계를 따라야 합니다.
- Mobility Accelerate (작업 기반): API 호출로 청구가 트리거되지 않아도 됩니다. 배송 작업에서 작업 결과가 SUCCEEDED로 설정되면 자동으로 발생합니다. 따라서 작업 결과를 FAILED 또는 SUCCEEDED로 올바르게 설정하는 것이 매우 중요합니다. 고객 엔지니어 (파트너 또는 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"
```
항목이 표시되면 백엔드 시스템에서 작업을 SUCCEEDED로 올바르게 설정하고 있음을 의미합니다.

참고: 실제로 완료된 이동 또는 작업 수가 보고된 통화 수와 일치하는지 확인하는 것이 중요합니다. 청구 이벤트가 보고되지만 실제 완료된 이동 또는 작업의 총액과 일치하지 않는 경우가 있습니다 (과소 보고).

통합 상태

프로덕션으로의 성공적인 이전은 결제가 올바르게 작동할 뿐만 아니라 API가 실행되지 않는 것을 보장해야 합니다. 이동성 서비스의 경우 Fleet Engine (Local Rides and Deliveries API)과의 통합이 제대로 구현되었는지 확인하는 것이 중요합니다.

이렇게 하려면 Cloud Logging을 열고 다음 쿼리를 사용하면 됩니다.

jsonPayload.errorResponse.code:*

문제가 있는 모든 로그 항목이 나열됩니다. 예를 들면 다음과 같습니다.

이러한 문제는 BigQuery와 같은 다른 Cloud 제품으로 내보낼 수 있습니다. Cloud Logging 쿼리를 기반으로 측정항목 및 알림을 구성할 수 있습니다.

이러한 기능은 Google Cloud 제품이므로 추가 비용이 발생할 수 있습니다. 파트너 또는 Google 담당자에게 문의하여 자세히 알아보세요.

결제 계정 구성

이제 모든 시스템에서 이동 또는 작업을 올바르게 보고하고 통합 오류가 없으면 프로젝트를 웰컴 레터에 포함되어 있고 이 문서의 이전 섹션에서 다룬 결제 계정으로 지정할 수 있습니다.

참고: 지도 파트너와 협력하는 경우 이 단계에서 도움을 받을 수 있으므로 아래 단계를 혼자 따르지 않아도 됩니다. 일부 지역에서는 Google과 직접 협력하는 경우 다음 단계를 따르세요.

다음 안내를 따르세요.

Google Cloud 콘솔 (https://console.cloud.google.com)을 엽니다.
프로덕션에서 사용할 새 프로젝트를 선택합니다.
해당 프로젝트의 결제 섹션으로 이동합니다. https://console.cloud.google.com/billing 링크를 통해 바로가기에 액세스할 수 있습니다.
결제 > '결제 계정 관리'를 클릭합니다.

프로젝트가 위와 다를 수 있습니다.
결제에서 생성된 프로덕션 프로젝트 중 하나 옆에 있는 점 3개 아이콘 을 클릭하고 '결제 계정 변경'을 선택합니다.
결제 > 결제 계정에서 드롭다운 목록에 있는 시작 안내 편지에서 받은 결제 계정 코드를 선택합니다. 그런 다음 '계정 설정'을 클릭합니다.
프로젝트가 새 결제 계정에 연결됩니다.

중요: 이 시점부터 이 프로젝트에서 보고된 모든 이동 또는 작업에 대해 이전에 설명한 대로 요금이 청구됩니다. 아직 결제 유효성 검사가 진행되지 않았다면 아직 결제 계정을 연결하지 마세요.
새 결제 수단을 추가한 후 '개요 > 결제 개요' 및 '결제 설정'으로 이동하여 정보가 올바른지 확인합니다. 청구 및 결제 업데이트에 대한 자세한 내용은 이 링크를 참고하세요. 결제와 관련된 문제가 있는 경우 결제 지원 케이스를 제출하거나 파트너 또는 Google 담당자에게 문의하세요.

결제 보고서

결제 보고서를 사용하면 프로젝트에 연결된 결제 계정과 관련된 비용을 파악할 수 있습니다.

참고: 지도 파트너와 협력하는 경우 필요한 관련 결제 정보가 제공되는지 파트너와 협력하여 확인하세요.

프로젝트에 연결된 결제 계정을 열고 '보고서'를 선택합니다. 그런 다음 다음 필터 집합을 사용할 수 있습니다.

여기서 염두에 두어야 할 주요 설정은 SKU별 그룹화 기준 필터입니다. 이 필터는 이전에 설명한 대로 초과 사용 여부를 비롯해 이동 및 작업에 관한 세부정보와 사용된 경우 다른 API에 관한 세부정보를 표시합니다.

보고서 정보는 매일 새로고침됩니다. 일중 정보가 필요한 경우 Cloud Logging 쿼리를 사용하여 하루 동안 발생한 청구 가능한 이벤트 수를 확인할 수 있습니다. 자세한 내용은 이전 섹션을 참고하세요.

단계적 확대 계획

중요한 점은 온보딩 계획입니다. 비즈니스 특성에 따라 일부 트래픽이 모빌리티 프로젝트로 이전되지 않는 경우가 많습니다. 예를 들어 일부 회사는 모든 지점, 프랜차이즈, 매장, 사무실 등에 새 솔루션을 출시하는 데 시간이 걸리므로 일부 트래픽은 이전 시스템을 사용하고 일부 트래픽은 새 프로젝트로 이동합니다.

또한 많은 경우 모든 트래픽이 모빌리티 사용 사례에 속하지 않습니다. 이는 매장 찾기, 차량 수령, 기타 내부 솔루션의 경우에 해당합니다. 이러한 계정은 Google Maps Platform 결제 계정을 가리켜야 합니다. 트래픽은 모빌리티 결제 계정과 별도로 유지해야 하기 때문입니다.

구현 정책을 준수하는 것이 중요합니다.

이동 기반 모델 - '주문형 차량 공유 및 배송 솔루션은 주문형 상업용 차량 및 배송 서비스에 사용하기 위한 것입니다. 이러한 서비스에는 일반적으로 (a) 특정 목적지로의 이동 (또는 특정 상품의 배송)을 요청하는 소비자와 (b) 요청과 매칭되고 서비스를 완료하기 위해 차량을 운전하는 운전자가 포함됩니다.”
작업 기반 모델 - 'Google Maps Platform 라스트마일 차량 솔루션은 상업용 라스트마일 배송 및 퍼스트마일 수령 서비스에 사용하기 위한 것입니다. 이러한 서비스에는 일반적으로 (a) 고객이 소유하거나 계약한 배송 차량, (b) 사전 계획된 경로에 따른 배송, (c) 배송 실행을 지원하는 운영팀이 있는 유통 센터 네트워크, (d) 배송을 추적한 후 수령하는 소비자가 포함됩니다.”

따라서 Google Maps Platform 결제 계정을 가리켜야 하는 시스템과 모빌리티 결제 계정을 가리켜야 하는 시스템을 파악해야 합니다. 여러 프로젝트가 있고 각 프로젝트가 올바른 결제 계정을 가리키는 것이 일반적입니다.

예를 들어 오늘 사용량 한도에 따라 모든 여정 / 작업에 10개의 지오코딩 요청이 포함된다고 가정해 보겠습니다. 이전이 몇 개월 걸리고 첫 달에 10만 건의 이동 / 작업을 보고하기 시작한다면 Geocoding API를 100만 번 호출할 수 있습니다. 하지만 비즈니스에서 5백만 개의 지오코딩 요청을 하는 경우 차이 (4백만 개)가 초과 사용량으로 보고될 수 있습니다. 여기에는 두 가지 옵션이 있습니다.

Google에 보고하는 여행 / 작업의 양을 늘리면 (램프업 계획 가속화) 더 높은 한도가 적용되므로 이 경우 월 50만 건의 여행 / 작업을 보고해야 합니다.
앞서 설명한 대로 계약 협상 중에 더 높은 한도를 협상합니다.
할인 등급을 높이고 초과 사용량보다 저렴한 비용을 지불하기 위해 Geocoding API 요청을 Google Maps Platform API로 지정합니다.

비즈니스 규모와 복잡성, 사용 사례에 따라 비용을 추정하는 것은 복잡할 수 있습니다. 파트너 또는 Google 담당자와 협력하여 기존 프로젝트를 사용하여 프로덕션 출시를 준비하는 가장 좋은 방법을 결정하세요.

요약하자면 적절한 램프업 계획을 만들려면 다음 단계가 필요합니다. 1. 구현 정책에 따라 모빌리티 관련 사용 사례와 그렇지 않은 사용 사례를 식별합니다. 2. 관련 사용 사례에 현재 사용되는 Google Maps Platform API와 그 볼륨을 파악합니다. 3. 이동성 솔루션이 구현된 후에도 Google Maps Platform API가 계속 필요한지 확인합니다. 예를 들어 Fleet Engine에서 ETA 계산이 자동으로 이루어지므로 Directions API를 사용하여 ETA를 더 이상 계산하지 않아도 될 수 있습니다. 4. 모빌리티 사용 사례를 새 모빌리티 플랫폼으로 완전히 마이그레이션하는 데 얼마나 걸리는지 파악합니다. 5. 사용 사례를 지원하기에 사용 한도가 충분한지 다시 한번 확인하세요. 6. 모든 Google Maps Platform 요청을 모빌리티 사용 사례의 모빌리티 결제 계정으로 접을 수 있는 변곡점을 파악합니다.

결론

결론적으로 결제 계정을 올바르게 구성하는 것은 가격 예측 가능성과 투명성을 위해 필수적입니다. 업계 최고 수준의 위치 서비스를 통합한 Google의 모빌리티 기술을 사용하면 기업은 청구 프로세스가 정확하고 효율적임을 확신할 수 있습니다. 이를 통해 비용을 절감할 뿐만 아니라 정보에 입각한 비즈니스 결정을 내리는 데 필요한 데이터와 통계를 얻을 수 있습니다. 또한 이러한 시스템에서 제공하는 투명성을 통해 기업은 지출을 명확하게 파악하여 예산을 더 효과적으로 관리할 수 있습니다.

다음 작업

GCP 콘솔에서 결제 계정을 설정합니다.
일반적인 결제에 대한 자세한 내용은
- Mobility Services 상업 문서
- 프로젝트의 결제 사용 설정, 사용 중지, 변경 bookmark_border