คู่มือการเรียกเก็บเงินสำหรับ Google Maps Platform and Mobility

ก่อนที่จะติดตั้งใช้งานโปรเจ็กต์ Google Maps ใหม่ในการผลิต คุณต้องตรวจสอบว่าการตั้งค่าถูกต้องเพื่อให้คุณชำระเงินในจำนวนที่ถูกต้องสำหรับผลิตภัณฑ์ที่คุณใช้ ในเอกสารนี้ เราจะกล่าวถึงแง่มุมต่างๆ เพื่อให้คุณมี (1) ความโปร่งใสในการเรียกเก็บเงิน - เพื่อให้ยืนยันการใช้งานได้ก่อนที่จะมีการออกใบแจ้งหนี้ และ (2) การตั้งค่าโปรเจ็กต์ที่ถูกต้อง - เพื่อให้มั่นใจว่าคุณจะใช้ผลิตภัณฑ์ของเราได้

แม้ว่ากระบวนการนี้จะค่อนข้างตรงไปตรงมา แต่พาร์ทเนอร์ Maps สามารถทำงานร่วมกับคุณเพื่อให้มั่นใจว่าโปรเจ็กต์จะย้ายได้อย่างถูกต้อง

แนวคิด

ในส่วนนี้ เราต้องการให้คุณเข้าใจข้อมูลพื้นฐานเกี่ยวกับการเรียกเก็บเงินของ Google Maps และการตั้งค่าต่างๆ ที่อาจมี ในหลายๆ สถานการณ์ไม่มีวิธีใดถูกหรือผิด ทั้งนี้ขึ้นอยู่กับประเภทของผลลัพธ์ที่คุณต้องการ

ในเอกสารนี้ เราจะพูดถึงโปรเจ็กต์ Google Cloud ของคุณเป็นอย่างมาก เนื่องจากผลิตภัณฑ์ Google Maps พร้อมให้บริการผ่านแอปนี้ ซึ่งหมายความว่าการกำหนดค่าที่เรากล่าวถึงในเอกสารนี้จะดำเนินการในโปรเจ็กต์ Google Cloud

บัญชีสำหรับการเรียกเก็บเงิน

ปัจจุบันบริษัททุกแห่งที่ใช้ผลิตภัณฑ์ Google Maps มีโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับผลิตภัณฑ์เหล่านั้น โปรเจ็กต์นี้ต้องมีการกำหนดค่าบัญชีสำหรับการเรียกเก็บเงิน บัญชีสำหรับการเรียกเก็บเงินมีหน้าที่รับผิดชอบในการสะสมการใช้งาน Google Maps ทั้งหมดและสร้างใบแจ้งหนี้ทุกเดือนตามการใช้งานดังกล่าว

สำหรับ Mobility จะมีการจัดสรรบัญชีสำหรับการเรียกเก็บเงินพิเศษ บัญชีการเรียกเก็บเงินนี้มีไว้สำหรับใช้กับกรณีการใช้งานที่เกี่ยวข้องกับการเดินทางเท่านั้น เช่น การแชร์รถ การนำส่ง และโลจิสติกส์

โปรเจ็กต์ Google Cloud หลายโปรเจ็กต์หรือโปรเจ็กต์เดียวสามารถใช้บัญชีสำหรับการเรียกเก็บเงินบัญชีเดียวได้

โปรเจ็กต์เดียวที่ชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินเดียวกัน

  • กรณีการใช้งานเฉพาะ (เช่น กรณีการใช้งานด้านการเดินทาง)
  • ใบแจ้งหนี้แยก
  • ส่วนลดจะขึ้นอยู่กับปริมาณการใช้งานของโปรเจ็กต์เดียวนี้

หลายโปรเจ็กต์ที่ชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินเดียวกัน

  • กรณีการใช้งานเดียวกัน
  • ใช้ประโยชน์จากระดับส่วนลดโดยการรวบรวมการใช้งาน
  • ใบแจ้งหนี้ฉบับเดียว

ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีสำหรับการเรียกเก็บเงินและข้อมูลอื่นๆ ที่เกี่ยวข้องได้ที่ลิงก์นี้

ดังที่กล่าวไว้ข้างต้น บัญชีสำหรับการเรียกเก็บเงินบัญชีเดียวสามารถชี้ไปยังหลายโปรเจ็กต์ได้ หากมีโปรเจ็กต์มากกว่า 1 โปรเจ็กต์ คุณควรระบุโปรเจ็กต์ที่จะใช้บริการการเดินทางของเราและเชื่อมโยงโปรเจ็กต์เหล่านั้นกับบัญชีการเรียกเก็บเงินสำหรับการเดินทาง โปรเจ็กต์ที่ไม่มีกรณีการใช้งานการเดินทางที่เชื่อมโยงอยู่ควรชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินของ Google Maps Platform ปกติที่คุณใช้อยู่ในปัจจุบันต่อไป หากต้องการรับบัญชีการเรียกเก็บเงินสำหรับการเดินทาง คุณต้องลงนามในข้อตกลงด้านการเดินทางกับ Google หรือผ่านพาร์ทเนอร์ ด้านล่างนี้คุณจะเห็นว่าบัญชีสำหรับการเรียกเก็บเงินอยู่ในสคีมาทั้งหมดอย่างไร และการตั้งค่าต่างๆ ที่เป็นไปได้

การตั้งค่าบัญชีสำหรับการเรียกเก็บเงินที่เป็นไปได้
การตั้งค่าบัญชีสำหรับการเรียกเก็บเงินที่เป็นไปได้

ทรัพยากรในระบบคลาวด์ บัญชีสำหรับการเรียกเก็บเงิน และการสร้างใบแจ้งหนี้

เมื่อพูดถึงราคา Google Maps Platform มีส่วนลดหลายระดับซึ่งพร้อมให้บริการผ่านพาร์ทเนอร์ Maps หรือกับ Google โดยตรงในบางสถานการณ์ ระดับเหล่านี้อิงตามปริมาณ ดังนั้นยิ่งใช้ผลิตภัณฑ์ของเรามากเท่าใด คุณก็จะยิ่งจ่ายน้อยลงเท่านั้น (ส่วนลดจะนำไปใช้กับแต่ละ SKU แยกกัน) ระบบการเรียกเก็บเงินของเราจะระบุโปรเจ็กต์ของคุณตามข้อมูลเข้าสู่ระบบที่คุณใช้เรียกผลิตภัณฑ์ของเรา ซึ่งอาจเป็นคีย์ API หรือบัญชีบริการสำหรับ Mobility API บางรายการ

คีย์ API

ระบบจะตรวจสอบสิทธิ์ Google Maps Platform API โดยใช้คีย์ API Google จะระบุบัญชีสำหรับการเรียกเก็บเงินของโปรเจ็กต์ Google Cloud ที่เกี่ยวข้องตามคีย์ API นี้ ซึ่งเป็นที่ที่จะมีการใช้งาน

ตัวอย่างคำขอไปยัง Geocoding API:

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

JWT

API บางรายการกำหนดให้ต้องมีรหัสโปรเจ็กต์ Google Cloud ใน URL และใช้ 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 สำหรับบริการการเดินทาง เราจะเรียกเก็บเงินตามปริมาณธุรกรรมการเดินทางที่เรียกเก็บเงินได้ ซึ่งคือการเดินทางหรืองาน (การจัดส่ง ไม่ใช่การรับ) ที่ทำสำเร็จ ซึ่งจะกำหนดก่อนลงนามในสัญญา หากคุณเป็นบริษัทให้บริการเรียกรถหรือจัดส่งอาหาร การให้บริการเรียกรถหรือการนำส่งที่เสร็จสมบูรณ์คือเมตริกความสำเร็จของคุณ ซึ่งสอดคล้องกับการเดินทาง งานใช้สำหรับบริษัทด้านโลจิสติกส์และผู้ค้าปลีกที่ต้องนำส่งพัสดุให้สำเร็จ

เราทราบดีว่าลูกค้า Mobility ใช้ผลิตภัณฑ์ Google Maps Platform ในการดำเนินการการเดินทางและการนำส่งด้วย ดังนั้น หากใช้บัญชีสำหรับการเรียกเก็บเงินด้านการเดินทาง คุณจะโทรหา Google Maps Platform ได้โดยไม่มีค่าใช้จ่ายตราบใดที่ยังคงปฏิบัติตามขีดจำกัดที่กำหนดไว้ล่วงหน้าภายในกรณีการใช้งานด้านการเดินทางเดียวกัน

ตัวอย่างเช่น หากคุณเป็นบริษัทจัดส่งอาหาร คุณจะเรียกใช้ Geocoding API ได้ 10 ครั้งต่อการเดินทางที่สำเร็จ 1 ครั้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดเหล่านี้ได้ที่ขีดจำกัดการใช้งานในเอกสารประกอบเกี่ยวกับ Mobility การเปลี่ยนแปลงขีดจำกัดจะต้องมีการแก้ไขสัญญา ดังนั้นโปรดปรึกษากับตัวแทนของ Google หรือพาร์ทเนอร์เพื่อพูดคุยเกี่ยวกับความต้องการเฉพาะของคุณ

เมื่อสิ้นเดือน ระบบจะออกใบแจ้งหนี้โดยอิงตาม (1) จำนวนการเดินทางหรืองานที่สำเร็จซึ่งรายงานในระบบ และ (2) ปริมาณการเรียกใช้ Google Maps Platform API ที่เกินขีดจำกัดที่กำหนดไว้ล่วงหน้า ("ส่วนเกิน") ขีดจำกัดของเราสอดคล้องกับสิ่งที่เราเห็นว่าจำเป็นในตลาดโดยทั่วไป

เราขอแนะนำให้อ่านเอกสารประกอบการเรียกเก็บเงินสำหรับการเดินทางอย่างเป็นทางการอย่างละเอียด ซึ่งดูได้ที่นี่

การนำร่องและการประเมิน

ลูกค้าสามารถเรียกใช้โปรแกรมนำร่องขนาดเล็ก (การพิสูจน์แนวคิด การประเมิน) ของบริการการเดินทางในบัญชีสำหรับการเรียกเก็บเงินของ Google Maps Platform เป็นระยะเวลาจำกัดก่อนที่จะลงนามในสัญญา หากต้องการเรียกใช้โปรแกรมนำร่อง โปรดปรึกษาพาร์ทเนอร์ Maps หรือตัวแทนของ Google

ในช่วงนำร่องนี้ ดังที่กล่าวไว้ จะไม่มีบัญชีสำหรับการเรียกเก็บเงินของ Mobility เนื่องจากยังไม่ได้ลงนามในสัญญา ซึ่งหมายความว่าเมื่อใดก็ตามที่มีการใช้ผลิตภัณฑ์ Google Maps Platform ระบบจะเรียกเก็บเงิน แต่จะไม่เรียกเก็บเงินสำหรับผลิตภัณฑ์เฉพาะด้านการเดินทาง กล่าวคือ ในช่วงนำร่อง การเรียกเก็บเงินจะไม่ขึ้นอยู่กับงานหรือการเดินทาง และด้วยเหตุนี้ ขีดจำกัดการใช้งานจึงไม่มีผลในช่วงนี้

เมื่อเปิดตัวเวอร์ชันนำร่องอย่างเป็นทางการในเวอร์ชันที่ใช้งานจริงแล้ว คุณจะต้องชำระเงินตามสัญญา

โดยสรุป

  • ระยะนำร่อง / การพัฒนา: คุณจะถูกเรียกเก็บเงินเฉพาะสำหรับ Google Maps API ที่พร้อมใช้งานแบบสาธารณะเท่านั้น API และ SDK ที่ไม่ได้เผยแพร่ต่อสาธารณะจะไม่มีการเรียกเก็บเงินจนกว่าจะมีการใช้บัญชีสำหรับการเรียกเก็บเงินของ Mobility ในโปรเจ็กต์ โปรดทราบว่า Google มีปริมาณการใช้งานฟรีสำหรับ SKU ของ Google Maps Platform แต่ละรายการสำหรับบัญชีสำหรับการเรียกเก็บเงินใหม่ที่สร้างขึ้น ซึ่งควรเพียงพอสำหรับสภาพแวดล้อมที่มีการควบคุมในช่วงระยะเวลาการประเมิน

  • ระยะการผลิต: ระบบจะเรียกเก็บเงินจากคุณตามการเดินทางหรืองาน ค่าใช้จ่ายที่เกี่ยวข้องกับ Google Maps Platform จะเกิดขึ้นก็ต่อเมื่อการใช้งานเกินขีดจำกัดการใช้งาน ("ขีดจำกัด") ของสัญญาเท่านั้น หากเป็นเช่นนั้น คุณจะต้องชำระค่าบริการส่วนเกิน ระบบจะเรียกเก็บเงินส่วนเกินตามที่ระบุไว้ที่นี่

วิธีย้ายข้อมูลไปยังบัญชีสำหรับการเรียกเก็บเงินของ Mobility

เมื่อย้ายข้อมูลไปยังเวอร์ชันที่ใช้งานจริง โดยปกติแล้วคุณจะต้องสร้างโปรเจ็กต์ Google Cloud เพิ่มเติมเพื่อแสดงถึงสภาพแวดล้อมต่างๆ เช่น QA (การประกันคุณภาพ) และเวอร์ชันที่ใช้งานจริง ก่อนหน้านี้ คุณอาจมีเพียงสภาพแวดล้อมเดียวคือสภาพแวดล้อมการพัฒนา

ข้อกำหนด

บุคคลในฝั่งของคุณที่ทำสิ่งต่อไปนี้ได้

  1. จัดการบัญชีสำหรับการเรียกเก็บเงินใน Google Cloud ซึ่งโดยปกติแล้วผู้ดูแลระบบบัญชีสำหรับการเรียกเก็บเงินหรือเจ้าของโปรเจ็กต์จะเป็นผู้ดำเนินการ
  2. สิทธิ์เข้าถึงรหัสบัญชีสำหรับการเรียกเก็บเงินใหม่ซึ่งมาพร้อมกับจดหมายต้อนรับที่สร้างขึ้นหลังจากลงนามในสัญญา
  3. สิทธิ์เข้าถึงโปรเจ็กต์ Google Cloud ที่สอดคล้องกับสภาพแวดล้อมการนำไปใช้งานจริงที่จะมีการรายงานการเดินทางหรืองาน

ทําตามขั้นตอนต่อไปนี้เพื่อตั้งค่าโปรเจ็กต์ใหม่และกําหนดค่าการเรียกเก็บเงินสําหรับโปรเจ็กต์เหล่านั้น

การตั้งค่าโปรเจ็กต์ใหม่

การสร้างโปรเจ็กต์

  1. [คุณ] สร้างโปรเจ็กต์ GCP ใหม่ในคอนโซล Google Cloud สำหรับแต่ละสภาพแวดล้อมใหม่ เช่น การผลิต การจัดเตรียม และการประกันคุณภาพ
  2. [พาร์ทเนอร์หรือทีม Google] เพิ่มโปรเจ็กต์ใหม่ลงในรายการที่อนุญาตเพื่อให้มีสิทธิ์เข้าถึง ผลิตภัณฑ์ Mobility ติดต่อตัวแทนฝ่ายขายที่ Google หรือพาร์ทเนอร์ แล้วระบุรหัสโปรเจ็กต์ที่สร้างขึ้นในขั้นตอนก่อนหน้า
  3. [คุณ] อัปเดต รายชื่อติดต่อที่จำเป็น ในโปรเจ็กต์ ขั้นตอนนี้สำคัญมากเพื่อให้ทีมสนับสนุนของ Google ติดต่อผู้ที่เหมาะสมสำหรับโปรเจ็กต์ของคุณได้หากจำเป็น

การกำหนดค่าโปรเจ็กต์

ทําตามขั้นตอนต่อไปนี้ใน Google Cloud Console สําหรับโปรเจ็กต์ ที่สร้างในขั้นตอนก่อนหน้า

  1. [คุณ] สร้างบัญชีบริการรวมถึงการเชื่อมโยงบทบาท Mobility Identify & Access Management (IAM) ที่ถูกต้อง (อิงตามการเดินทาง และอิงตามงาน)

    • เนื่องจากมีการดำเนินการในสภาพแวดล้อมการพัฒนาหรือมีการแยกสิทธิ์การเข้าถึงที่มีโครงสร้างมากขึ้นหากจำเป็น โปรดดูส่วนนี้
  2. [คุณ] สร้างคีย์ API - ตามที่ทำในสภาพแวดล้อมการพัฒนาหรือ มีการแยกการเข้าถึงที่มีโครงสร้างมากขึ้น (เช่น ต่อผลิตภัณฑ์ โดเมน ฯลฯ) หากจำเป็น

  3. [คุณ] เปิดใช้ API เช่น "การเดินทางและการนำส่งในพื้นที่" และ Google Maps Platform API อื่นๆ ที่จำเป็น (เช่น Geocoding, Autocomplete, การตรวจสอบที่อยู่)

  4. โควต้า [ของคุณ]: หากต้องการเพิ่ม QPM (คำค้นหาต่อนาที) สำหรับ API บางรายการ โปรดเปิดคำขอแจ้งปัญหาเพื่อรับการสนับสนุน ดูวิธีดำเนินการได้ที่นี่ คุณต้องเพิ่มเหตุผลทางธุรกิจที่ระบุว่าเหตุใดจึงต้องมีการเพิ่ม ดูโควต้าที่กำหนดไว้ล่วงหน้าได้ที่นี่

  5. [คุณ] หากมีระบบที่พัฒนาขึ้นโดยใช้ข้อมูลเข้าสู่ระบบจาก สภาพแวดล้อมการพัฒนา โปรดตรวจสอบว่าระบบเหล่านี้สามารถชี้ไปยัง ข้อมูลเข้าสู่ระบบใหม่ที่สร้างขึ้นสำหรับโปรเจ็กต์ใหม่ที่สร้างขึ้นได้ ซึ่งรวมถึงการชี้ระบบแบ็กเอนด์และฟรอนต์เอนด์ไปยังข้อมูลเข้าสู่ระบบใหม่ เช่น คีย์ API, บัญชีบริการ และการตรวจสอบว่ามีการใช้รหัสโปรเจ็กต์ที่ถูกต้อง ในแต่ละสภาพแวดล้อมที่เกี่ยวข้อง

การกำหนดค่าการเรียกเก็บเงิน

ในที่นี้ เราจะถือว่าคุณได้ลงนามในสัญญากับ Google โดยตรง (ในกรณีที่เกี่ยวข้อง) หรือผ่านพาร์ทเนอร์แล้ว นี่เป็นข้อกำหนดเบื้องต้นในการรับบัญชีการเรียกเก็บเงินสำหรับการเดินทางในจดหมายต้อนรับ ซึ่งจะใช้ในขั้นตอนถัดไป

  1. [คุณ] ตรวจสอบว่าได้รับรหัสบัญชีการเรียกเก็บเงินของ Mobility เป็นส่วนหนึ่งของจดหมายต้อนรับที่ Google ส่งทางอีเมลหลังจากลงนามและดำเนินการตามสัญญาแล้ว สำคัญ: เราจะส่งจดหมายต้อนรับไปยังผู้ติดต่อด้านเทคนิคและการเงินที่ระบุไว้ในแบบฟอร์มคำสั่งซื้อของสัญญา ทำงานร่วมกับทีมโปรเจ็กต์เพื่อทำความเข้าใจว่าใครอาจได้รับอีเมลดังกล่าว และขอให้บุคคลนั้นระบุรหัสบัญชีการเรียกเก็บเงินซึ่งเป็นชุดอักขระและตัวเลขที่คั่นด้วยขีดกลาง
  2. [คุณ] ร่วมงานกับ Google หรือพาร์ทเนอร์เพื่อให้แน่ใจว่าได้ดำเนินการตรวจสอบการเรียกเก็บเงินแล้ว ซึ่งหมายความว่าระบบของคุณรายงานการเดินทางหรืองานไปยัง Google อย่างถูกต้องแล้ว ดูรายละเอียดเพิ่มเติมได้ในส่วนถัดไป
  3. [คุณ] ชี้โปรเจ็กต์ Google Cloud ไปยังบัญชีสำหรับการเรียกเก็บเงินใหม่โดยใช้ Cloud Console - ดูส่วนการกำหนดค่าบัญชีสำหรับการเรียกเก็บเงินในเอกสารนี้

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินโดยทั่วไปได้ที่นี่และที่นี่

การตรวจสอบการเรียกเก็บเงิน

การตรวจสอบการเรียกเก็บเงินเป็นสิ่งสำคัญเพื่อให้มั่นใจว่าคุณจะถูกเรียกเก็บเงินอย่างถูกต้อง บางครั้งบริษัทต่างๆ อาจนำ API ไปใช้อย่างไม่ถูกต้องโดยไม่ได้ตั้งใจ ซึ่งอาจทำให้มีการเรียกเก็บเงินเพิ่มขึ้นหรือรายงานข้อมูลต่ำกว่าความเป็นจริง

การตรวจสอบการเรียกเก็บเงินมีขั้นตอนต่อไปนี้

  1. การยืนยันว่าคำขอไปยัง API ของ Google Maps Platform มี tripId (หรือ taskId) ในส่วนหัวของคำขอหรือไม่ ดูรายละเอียดเพิ่มเติมที่นี่

  2. ตรวจสอบว่ามีการรายงานการเดินทาง (หรืองาน) อย่างถูกต้องหรือไม่ ซึ่งขึ้นอยู่กับแพ็กเกจการเดินทางที่ใช้ ดังนี้

    • Mobility Starter และ Optimize หรือ Accelerate (อิงตามการเดินทาง): ต้องผสานรวมกับ ReportBillableEvent API ซึ่งหมายความว่าทุกครั้งที่การเดินทางเสร็จสมบูรณ์แล้ว จะต้องส่งคำขอไปยัง API นี้ หากต้องการตรวจสอบว่าการดำเนินการนี้เกิดขึ้นอย่างถูกต้องหรือไม่ คุณต้องทำตามขั้นตอนที่อธิบายไว้ที่นี่
    • Mobility Accelerate (อิงตามงาน): ไม่จำเป็นต้องทริกเกอร์การเรียกเก็บเงินด้วยการเรียก 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"
    

    หากรายการแสดงอยู่ แสดงว่าระบบแบ็กเอนด์ของคุณตั้งค่างานเป็น SUCCEEDED อย่างถูกต้อง

    หมายเหตุ: อย่างไรก็ตาม คุณควรตรวจสอบว่าจำนวนการเดินทางหรือจำนวนงานที่ทำสำเร็จจริงตรงกับจำนวนการโทรที่รายงานหรือไม่ บางครั้งเราเห็นการรายงานเหตุการณ์การเรียกเก็บเงิน แต่เหตุการณ์ดังกล่าวไม่สอดคล้องกับจำนวนการเดินทางหรืองานทั้งหมดที่ดำเนินการเสร็จสมบูรณ์จริงในชีวิตจริง (รายงานต่ำกว่าความเป็นจริง)

สถานะประสิทธิภาพการผสานรวม

การย้ายข้อมูลไปยังเวอร์ชันที่ใช้งานจริงที่สำเร็จไม่เพียงรับประกันว่าการเรียกเก็บเงินจะทำงานได้อย่างถูกต้อง แต่ยังรับประกันว่า API จะไม่ทำงานล้มเหลวด้วย สำหรับบริการการเดินทาง คุณต้องตรวจสอบว่าการผสานรวมกับ Fleet Engine (Local Rides and Deliveries API) ได้รับการติดตั้งใช้งานอย่างถูกต้อง

โดยคุณสามารถเปิด Cloud Logging และใช้การค้นหาต่อไปนี้

jsonPayload.errorResponse.code:*

ซึ่งควรแสดงรายการบันทึกทั้งหมดที่มีปัญหา ตัวอย่างเช่น

การค้นหาข้อผิดพลาดโดยใช้ Cloud Logging
การค้นหาข้อผิดพลาดโดยใช้ Cloud Logging

คุณสามารถส่งออกปัญหาเหล่านั้นไปยังผลิตภัณฑ์อื่นๆ ของ Cloud เช่น BigQuery ได้ คุณกำหนดค่าเมตริกและการแจ้งเตือนได้โดยอิงตามการค้นหาใน Cloud Logging ดังนี้

การสร้างเมตริกจากการค้นหา Cloud Logging
การสร้างเมตริกจากการค้นหาใน Cloud Logging

เนื่องจากเป็นผลิตภัณฑ์ของ Google Cloud จึงอาจมีค่าใช้จ่ายเพิ่มเติม คุณสามารถพูดคุยกับพาร์ทเนอร์หรือตัวแทนของ Google เพื่อให้เข้าใจชัดเจนยิ่งขึ้น

การกำหนดค่าบัญชีสำหรับการเรียกเก็บเงิน

หากตอนนี้ระบบทั้งหมดรายงานการเดินทางหรืองานอย่างถูกต้องและไม่มีข้อผิดพลาดในการผสานรวม ก็ถึงเวลาเชื่อมต่อโปรเจ็กต์กับบัญชีสำหรับการเรียกเก็บเงินที่คุณได้รับเป็นส่วนหนึ่งของจดหมายต้อนรับและที่กล่าวถึงในส่วนก่อนหน้าของเอกสารนี้

หมายเหตุ: หากคุณทำงานร่วมกับพาร์ทเนอร์ Maps พาร์ทเนอร์จะช่วยคุณได้ในขั้นตอนนี้ และคุณไม่จำเป็นต้องทำตามขั้นตอนด้านล่างด้วยตนเอง หากคุณทำงานร่วมกับ Google โดยตรง (ซึ่งอาจเกิดขึ้นในบางภูมิภาค) ให้ทำตามขั้นตอนถัดไป

โดยสิ่งที่คุณต้องทำมีดังนี้

  1. เปิด Google Cloud Console (https://console.cloud.google.com)
  2. เลือกโปรเจ็กต์ใหม่ที่จะใช้ในเวอร์ชันที่ใช้งานจริง
  3. ไปที่ส่วนการเรียกเก็บเงินของโปรเจ็กต์นั้น คุณสามารถเข้าถึงลิงก์ https://console.cloud.google.com/billing ได้โดยตรง
  4. การเรียกเก็บเงิน > คลิก "จัดการบัญชีสำหรับการเรียกเก็บเงิน"
    บัญชีสำหรับการเรียกเก็บเงินหลายบัญชี
    โปรเจ็กต์ของคุณอาจมีลักษณะแตกต่างจากด้านบน
  5. ในการเรียกเก็บเงิน > คลิกไอคอน 3 จุด เปิดดูรายละเอียดเพิ่มเติม ข้างโปรเจ็กต์เวอร์ชันที่ใช้งานจริงที่สร้างขึ้น แล้วเลือก "เปลี่ยนบัญชีสำหรับการเรียกเก็บเงิน"
    เลือกโปรเจ็กต์
  6. การเรียกเก็บเงิน > ในบัญชีสำหรับการเรียกเก็บเงิน ให้เลือกรหัสบัญชีสำหรับการเรียกเก็บเงินที่คุณได้รับในจดหมายต้อนรับจากรายการแบบเลื่อนลง จากนั้นคลิก "ตั้งค่าบัญชี"
    เลือกโปรเจ็กต์
  7. โปรเจ็กต์จะลิงก์กับบัญชีสำหรับการเรียกเก็บเงินใหม่ดังนี้
    เลือกบัญชีสำหรับการเรียกเก็บเงินที่ถูกต้อง
    สำคัญ: ตั้งแต่นี้เป็นต้นไป ระบบจะเรียกเก็บเงินสำหรับการเดินทางหรืองานทั้งหมดที่รายงานในโปรเจ็กต์นี้ตามที่อธิบายไว้ก่อนหน้านี้ หากยังไม่ได้ตรวจสอบการเรียกเก็บเงิน อย่าเพิ่งลิงก์บัญชีสำหรับการเรียกเก็บเงิน
  8. หลังจากเพิ่มวิธีการเรียกเก็บเงินใหม่แล้ว ให้ไปที่ "ภาพรวม > ภาพรวมการชำระเงิน" และ "การตั้งค่าการชำระเงิน" เพื่อยืนยันว่าข้อมูลถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตการเรียกเก็บเงินและการชำระเงินได้ที่ลิงก์นี้ หากพบปัญหาเกี่ยวกับการเรียกเก็บเงิน โปรดส่งเคสขอรับความช่วยเหลือด้านการเรียกเก็บเงิน หรือติดต่อตัวแทนของพาร์ทเนอร์หรือ Google

รายงานการเรียกเก็บเงิน

รายงานการเรียกเก็บเงินช่วยให้คุณเข้าใจค่าใช้จ่ายที่เชื่อมโยงกับบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์กับโปรเจ็กต์

หมายเหตุ: หากคุณทำงานร่วมกับพาร์ทเนอร์ของ Maps โปรดทำงานร่วมกับพาร์ทเนอร์เพื่อให้แน่ใจว่าคุณจะได้รับข้อมูลการเรียกเก็บเงินที่เกี่ยวข้องซึ่งคุณต้องการ

เปิดบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์ของโปรเจ็กต์ แล้วเลือกรายงาน จากนั้นคุณจะใช้ชุดตัวกรองต่อไปนี้ได้

ตัวกรองรายงานการเรียกเก็บเงิน
ตัวกรองรายงานการเรียกเก็บเงิน

การตั้งค่าหลักที่ควรทราบคือตัวกรองจัดกลุ่มตาม SKU ซึ่งจะแสดงข้อมูลโดยละเอียดเกี่ยวกับ Trips และ Tasks รวมถึง API อื่นๆ หากมีการใช้งาน ซึ่งรวมถึงการพิจารณาว่ามีการใช้งานเกินโควต้าหรือไม่ ดังที่อธิบายไว้ก่อนหน้านี้

ตัวกรองรายงานการเรียกเก็บเงิน
ตัวอย่างผลิตภัณฑ์ที่ใช้ในโปรเจ็กต์

ระบบจะรีเฟรชข้อมูลรายงานทุกวัน หากจำเป็นต้องใช้ข้อมูลระหว่างวัน คุณสามารถใช้การค้นหา Cloud Logging เพื่อดูจำนวนเหตุการณ์ที่เรียกเก็บเงินได้ที่เกิดขึ้นในระหว่างวัน ดูส่วนก่อนหน้าสำหรับข้อมูลนี้

แผนการเพิ่มประสิทธิภาพ

สิ่งสำคัญที่ควรกล่าวถึงคือแผนการเพิ่มประสิทธิภาพ โดยปกติแล้ว ระบบจะไม่ย้ายข้อมูลการเข้าชมทั้งหมดไปยังโปรเจ็กต์การเดินทาง ทั้งนี้ขึ้นอยู่กับลักษณะธุรกิจของคุณ ตัวอย่างเช่น บางบริษัทใช้เวลาในการเปิดตัวโซลูชันใหม่ในสาขา แฟรนไชส์ ร้านค้า สำนักงาน ฯลฯ ทั้งหมด ซึ่งหมายความว่าการเข้าชมบางส่วนจะใช้ระบบเก่า และการเข้าชมบางส่วนจะไปยังโปรเจ็กต์ใหม่

นอกจากนี้ ในหลายกรณี การเข้าชมบางส่วนอาจไม่ได้อยู่ในกรณีการใช้งานการเดินทาง ซึ่งเป็นกรณีของเครื่องมือระบุตำแหน่งร้านค้า การรับสินค้าที่ริมทาง และโซลูชันภายในอื่นๆ ซึ่งควรชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินของ Google Maps Platform เนื่องจากควรแยกการเข้าชมออกจากบัญชีสำหรับการเรียกเก็บเงินของ Mobility

คุณต้องปฏิบัติตามนโยบายการติดตั้งใช้งาน

  • รูปแบบตามการเดินทาง - "โซลูชันการโดยสารและการนำส่งแบบออนดีมานด์มีไว้สำหรับใช้ในบริการโดยสารและการนำส่งเชิงพาณิชย์แบบออนดีมานด์ โดยปกติแล้ว บริการดังกล่าวจะรวมถึง (ก) ผู้บริโภคที่ส่งคำขอใช้บริการรถไปยังจุดหมายที่กำหนด (หรือนำส่งสินค้าที่เฉพาะเจาะจง) และ (ข) คนขับที่ได้รับการจับคู่กับคำขอ และขับรถเพื่อให้บริการให้เสร็จสมบูรณ์"
  • โมเดลตามงาน - "Google Maps Platform Last Mile Fleet Solution มีไว้สำหรับใช้ในบริการจัดส่งเชิงพาณิชย์ช่วงกิโลเมตรสุดท้ายและบริการรับสินค้าช่วงกิโลเมตรแรก โดยปกติแล้ว บริการดังกล่าวจะรวมถึง (ก) กลุ่มยานพาหนะนำส่งที่ลูกค้าเป็นเจ้าของหรือทำสัญญา (ข) การนำส่งตามเส้นทางที่วางแผนไว้ล่วงหน้า (ค) เครือข่ายศูนย์กระจายสินค้าที่มีทีมปฏิบัติการที่สนับสนุนการนำส่ง และ (ง) ผู้บริโภคที่ติดตามและรับสินค้าที่จัดส่ง"

ดังนั้นคุณควรทำความเข้าใจว่าระบบใดที่ควรชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินของ Google Maps Platform และระบบใดที่ควรชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินของ Mobility โดยปกติแล้วจะมีหลายโปรเจ็กต์และแต่ละโปรเจ็กต์จะชี้ไปยังบัญชีสำหรับการเรียกเก็บเงินที่ถูกต้อง

ตัวอย่างเช่น ทุกการเดินทาง / งานมีคำขอ Geocoding 10 รายการในปัจจุบันตามขีดจำกัดการใช้งาน หากการย้ายข้อมูลใช้เวลา 2-3 เดือนและคุณเริ่มรายงานการเดินทาง / งาน 100, 000 รายการในเดือนแรก นั่นหมายความว่าคุณอาจเรียกใช้ Geocoding API ได้ 1 ล้านครั้ง แต่หากธุรกิจของคุณส่งคำขอ Geocoding 5 ล้านรายการ ความแตกต่างดังกล่าว (4 ล้านรายการ) อาจได้รับการรายงานเป็นการใช้งานเกินโควต้า คุณมี 2 ตัวเลือกดังนี้

  1. คุณเพิ่มจำนวนการเดินทาง / งานที่รายงานให้เรา (เร่งแผนการเพิ่มประสิทธิภาพ) จึงมีขีดจำกัดที่สูงขึ้น ในกรณีนี้ คุณจะต้องรายงานการเดินทาง / งาน 500,000 รายการต่อเดือน
  2. คุณเจรจาต่อรองขีดจํากัดที่สูงขึ้นระหว่างการเจรจาสัญญาตามที่อธิบายไว้ก่อนหน้านี้
  3. คุณส่งคำขอ Geocoding API ไปยัง Google Maps Platform API เพื่อรับประโยชน์จากระดับส่วนลดที่สูงขึ้นและจ่ายเงินถูกกว่าค่าใช้จ่ายส่วนเกิน

เราทราบดีว่าการประมาณต้นทุนตามขนาดและความซับซ้อนของธุรกิจและกรณีการใช้งานอาจมีความซับซ้อน โปรดทำงานร่วมกับพาร์ทเนอร์หรือผู้รับผิดชอบของ Google เพื่อพิจารณาว่าวิธีใดดีที่สุดในการเตรียมพร้อมสำหรับการเปิดตัวเวอร์ชันที่ใช้งานจริงโดยใช้โปรเจ็กต์ที่มีอยู่

โดยสรุปแล้ว หากต้องการสร้างแผนการเพิ่มประสิทธิภาพที่เหมาะสม คุณต้องทำตามขั้นตอนต่อไปนี้ 1. ระบุกรณีการใช้งานที่เกี่ยวข้องกับการเดินทางและที่ไม่เกี่ยวข้องตามนโยบายการใช้งาน 2. ระบุว่าวันนี้มีการใช้ Google Maps Platform API ใดสำหรับกรณีการใช้งานที่เกี่ยวข้องและปริมาณการใช้งาน 3. ระบุว่ายังคงต้องใช้ Google Maps Platform API หลังจากติดตั้งใช้งานโซลูชันการเดินทางหรือไม่ เช่น การคำนวณเวลาถึงโดยประมาณจะเกิดขึ้นโดยอัตโนมัติใน Fleet Engine คุณจึงอาจไม่จำเป็นต้องคำนวณด้วย Directions API อีกต่อไป 4. ระบุระยะเวลาที่ใช้ในการย้ายข้อมูลกรณีการใช้งานการเดินทางอย่างเต็มรูปแบบไปยังแพลตฟอร์มการเดินทางใหม่ในฝั่งของคุณ 5. ตรวจสอบอีกครั้งว่าโควต้าการใช้งานเพียงพอที่จะรองรับกรณีการใช้งานของคุณหรือไม่ 6. ระบุจุดเปลี่ยนเมื่อคำขอ Google Maps Platform ทั้งหมดสามารถส่งไปยังบัญชีสำหรับการเรียกเก็บเงินค่าบริการการเดินทางสำหรับกรณีการใช้งานการเดินทางได้

บทสรุป

โดยสรุป การกำหนดค่าบัญชีสำหรับการเรียกเก็บเงินอย่างถูกต้องเป็นสิ่งสำคัญเพื่อให้คาดการณ์ราคาและความโปร่งใสได้ การใช้เทคโนโลยีการเดินทางของเราซึ่งรวมบริการตำแหน่งที่ดีที่สุดในระดับเดียวกันจะช่วยให้บริษัทมั่นใจได้ว่ากระบวนการเรียกเก็บเงินจะถูกต้องและมีประสิทธิภาพ ซึ่งไม่เพียงช่วยลดต้นทุน แต่ยังให้ข้อมูลและข้อมูลเชิงลึกที่จำเป็นต่อการตัดสินใจทางธุรกิจอย่างรอบคอบด้วย นอกจากนี้ ความโปร่งใสที่ระบบดังกล่าวมีจะช่วยให้บริษัทต่างๆ เข้าใจค่าใช้จ่ายของตนเองได้อย่างชัดเจน ซึ่งจะนำไปสู่การจัดการงบประมาณที่ดีขึ้น

การดำเนินการถัดไป