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

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

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

แนวคิด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

คีย์ API

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

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

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

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

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

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

นักบินและการประเมิน

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

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

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

สรุปได้ดังนี้

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

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

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

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

ข้อกำหนด

คนที่อยู่เคียงข้างคุณที่ทำสิ่งต่อไปนี้ได้

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

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

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

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

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

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

ขั้นตอนด้านล่างควรดำเนินการใน Google Cloud Console ในโปรเจ็กต์ที่สร้างขึ้นในขั้นตอนก่อนหน้า

  1. [คุณ] การสร้างบัญชีบริการซึ่งรวมถึงการเชื่อมโยงบทบาทการจัดการ Mobility Identity & Access Management (IAM) ที่ถูกต้อง (ตามการเดินทางและตามงาน) ตามที่เคยทำในสภาพแวดล้อมการพัฒนาหรือการแยกการเข้าถึงที่มีโครงสร้างมากขึ้นหากจำเป็น โปรดดูส่วนนี้
  2. [คุณ] การสร้างคีย์ API ตามที่เคยทำในสภาพแวดล้อมการพัฒนา หรือการแบ่งแยกสิทธิ์เข้าถึงที่มีโครงสร้างมากขึ้น (เช่น ต่อผลิตภัณฑ์ โดเมน ฯลฯ) หากจำเป็น
  3. [คุณ] เปิดใช้ API เช่น “Local Rides and Deliveries” และ Google Maps Platform API อื่นๆ ที่จำเป็นต้องใช้ (เช่น การระบุพิกัดทางภูมิศาสตร์ การเติมข้อความอัตโนมัติ การตรวจสอบที่อยู่)
  4. [คุณ] โควต้า: หากคุณต้องการการเพิ่มขึ้นของ QPS (จำนวนคำค้นหาต่อวินาที) สำหรับ API บางรายการ ให้เปิดคำขอแจ้งปัญหาเพื่อรองรับ ดูวิธีดำเนินการที่นี่ คุณต้องเพิ่มเหตุผลรองรับทางธุรกิจที่ระบุว่าเหตุใดจึงต้องมีการเพิ่มขึ้น ดูโควต้าที่กำหนดไว้ล่วงหน้าได้ที่นี่
  5. [คุณ] หากคุณมีระบบที่พัฒนาซึ่งใช้ข้อมูลเข้าสู่ระบบจากสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ ให้ตรวจสอบว่าระบบเหล่านี้สามารถชี้ไปยังข้อมูลเข้าสู่ระบบใหม่ที่สร้างขึ้นสำหรับโปรเจ็กต์ใหม่ได้ ซึ่งรวมถึงการชี้ระบบแบ็กเอนด์และฟรอนท์เอนด์ไปยังข้อมูลเข้าสู่ระบบใหม่ เช่น คีย์ API, บัญชีบริการ และตรวจสอบว่ามีการใช้รหัสโปรเจ็กต์ที่ถูกต้องในแต่ละสภาพแวดล้อมที่เกี่ยวข้อง

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

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

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

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

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

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

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

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

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

    • Mobility Starter and Optimize หรือ Accelerate (Trip based): ต้องผสานรวมกับ 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:*

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

แผนการเพิ่มจำนวน

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

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

สิ่งสำคัญคือคุณต้องปฏิบัติตามนโยบายการใช้งาน:

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

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

ตัวอย่างเช่น ลองพิจารณาว่าทุกการเดินทาง / งานมีคำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์ 10 รายการในวันนี้ตามขีดจำกัดการใช้งาน หากการย้ายข้อมูลของคุณจะใช้เวลา 2-3 เดือนและคุณเริ่มรายงานการเดินทาง / งาน 100, 000 รายการในเดือนแรก หมายความว่าคุณสามารถเรียกใช้ Geocoding API 1 ล้านครั้ง แต่หากธุรกิจของคุณขอให้ระบุพิกัดทางภูมิศาสตร์ 5M นั้น (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. ระบุระยะเวลาที่ใช้ในการย้ายข้อมูล Use Case ด้านอุปกรณ์เคลื่อนที่อย่างเต็มรูปแบบไปยังแพลตฟอร์มการเคลื่อนไหวแบบใหม่ที่ฝั่งคุณ 5. ตรวจสอบอีกครั้งว่าขีดจำกัดการใช้งานเพียงพอที่จะรองรับกรณีการใช้งานของคุณหรือไม่ 6. ระบุจุดเปลี่ยนที่เวลาคำขอทั้งหมดของ Google Maps Platform สามารถผสานรวมไปยังบัญชีสำหรับการเรียกเก็บเงินค่าอุปกรณ์เคลื่อนที่สำหรับกรณีการใช้งานด้านการเดินทางได้

บทสรุป

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

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