คำแนะนำในการย้ายข้อมูลรหัสไคลเอ็นต์

ภาพรวม

เพื่อเพิ่มความปลอดภัยและความน่าเชื่อถือในการตรวจสอบสิทธิ์ เราได้เลิกใช้งานรหัสไคลเอ็นต์ของ Maps Platform ตั้งแต่วันที่ 26 พฤษภาคม 2025 และจะใช้ไม่ได้อีกต่อไปหลังจากวันที่ 31 พฤษภาคม 2026

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

ทำตามขั้นตอนต่อไปนี้เพื่อเริ่มต้น:

  1. ตรวจสอบการใช้งานรหัสไคลเอ็นต์ปัจจุบัน
  2. เตรียมคีย์ API
  3. ตรวจสอบการตั้งค่าโควต้า
  4. อัปเดตโค้ด
  5. ตรวจสอบการเข้าชมรหัสไคลเอ็นต์
  6. หยุดรหัสไคลเอ็นต์ชั่วคราว

ตรวจสอบการใช้งานรหัสไคลเอ็นต์ปัจจุบัน

ก่อนเริ่มกระบวนการย้ายข้อมูล ให้ทำรายการต่อไปนี้

  • บริการ Maps Platform ที่คุณใช้กับรหัสไคลเอ็นต์
  • แอปพลิเคชัน เว็บไซต์ หรือระบบที่คุณใช้รหัสไคลเอ็นต์

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

ใน Cloud Console คุณสามารถตรวจสอบสถานะล่าสุดของการใช้งาน Client ID ได้ ในหน้าเมตริกของ Google Maps

ดูรายการบริการของ Maps Platform

  1. เปิดหน้าเมตริกใน Cloud Console
  2. กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
    • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
  3. ตั้งค่าตัวกรองต่อไปนี้
    • จัดกลุ่มตาม: API

สำหรับคำแนะนำเกี่ยวกับแอปพลิเคชัน เว็บไซต์ หรือระบบ

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

  1. เปิดหน้าเมตริกใน Cloud Console
  2. เลือกบริการ Maps Platform จากเมนูแบบเลื่อนลง
  3. กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
    • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
  4. ตั้งค่าตัวกรองต่อไปนี้
    • จัดกลุ่มตาม: แพลตฟอร์มหรือโดเมน
  5. ทำซ้ำตั้งแต่ขั้นตอนที่ 2 สำหรับบริการ Maps Platform แต่ละรายการที่คุณต้องการ ตรวจสอบการเข้าชม

เตรียมคีย์ API

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

  1. ค้นหาโปรเจ็กต์ระบบคลาวด์ที่ลิงก์กับรหัสไคลเอ็นต์ของคุณ
  2. ตรวจสอบว่าโปรเจ็กต์ Cloud ลิงก์กับบัญชีสำหรับการเรียกเก็บเงินที่เปิดอยู่
  3. สร้างคีย์ API ใหม่ สำหรับการย้ายข้อมูลรหัสไคลเอ็นต์
    • คุณนำคีย์ API ที่มีอยู่มาใช้ใหม่ในโปรเจ็กต์ระบบคลาวด์ได้
    • คุณสามารถใช้คีย์ API หลายรายการจากโปรเจ็กต์ Cloud เดียวกันได้ เช่น เพื่อแยกการรับส่งข้อมูลสำหรับบริการ Maps Platform แต่ละรายการ หรือเพื่อแยกการรับส่งข้อมูลจากแพลตฟอร์มต่างๆ (เบราว์เซอร์ แอปบนอุปกรณ์เคลื่อนที่ และอื่นๆ) โปรดดูแนวทางปฏิบัติแนะนำเกี่ยวกับการจัดการคีย์ API ในคู่มือด้านความปลอดภัย

รักษาคีย์ API ให้ปลอดภัย

โปรดรักษาคีย์ API ให้ปลอดภัยเพื่อปกป้องคีย์จากการเข้าถึงที่ไม่ได้รับอนุญาต

  • ตั้งค่าการจำกัดแอปพลิเคชันสำหรับคีย์ API (เช่น เว็บไซต์ ที่อยู่ IP, แอป Android หรือแอป iOS)
  • ตั้งค่าข้อจำกัด API สำหรับคีย์ API

โปรดดูรายละเอียดเพิ่มเติมที่คำแนะนำด้านความปลอดภัยของ Google Maps Platform

สำหรับ Maps JavaScript API, Maps Static API และ Street View Static API คุณสามารถ ย้ายข้อมูลผู้แนะนำที่เชื่อถือได้ใน Client ID ไปยังข้อจำกัดคีย์ API คุณดูรายการผู้แนะนำที่เชื่อถือได้ใน Cloud Console

ตรวจสอบการตั้งค่าโควต้า

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานโควต้า

การเพิ่มโควต้าสำหรับบริการฝั่งไคลเอ็นต์ของ Maps JavaScript API

หากคุณใช้บริการต่อไปนี้ใน Maps JavaScript API คุณจะเห็นการใช้งานโควต้าเพิ่มขึ้นหลังจากย้ายข้อมูลคีย์ API

ตรวจสอบการกำหนดค่าโควต้าปัจจุบัน การใช้งานปัจจุบัน และ ปรับขีดจำกัดโควต้าตามนั้น

  1. ตรวจสอบว่าคุณใช้บริการฝั่งไคลเอ็นต์ของ Maps JavaScript API ที่มี รหัสไคลเอ็นต์
    • เปิดหน้าเมตริกใน Cloud Console
    • กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
      • จัดกลุ่มตาม: เมธอดของ API
      • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
    • จากนั้นคุณจะเห็นรายการชื่อเมธอดพร้อมการเข้าชมในแผนภูมิ "การเข้าชม ตามเมธอด API"

เมธอดของ API

บริการฝั่งไคลเอ็นต์

บริการเพื่อปรับโควต้า

google.routes.Directions.Javascript

บริการเส้นทาง

Directions API

google.routes.DistanceMatrix.Javascript

บริการเมทริกซ์ระยะทาง

Distance Matrix API

google.maps.Elevation.Javascript

บริการระดับความสูง

Elevation API

google.places.Geocoding.Javascript

บริการการเข้ารหัสพิกัดภูมิศาสตร์

Geocoding API

google.places.*.Javascript นอกเหนือจาก google.places.Geocoding.Javascript

Places Library

Places API
  • หากไม่ได้ใช้วิธีการ API เหล่านั้น คุณก็ไม่ต้องกังวลเกี่ยวกับการตั้งค่าโควต้า เนื่องจากการเข้าชมรหัสไคลเอ็นต์จะใช้โควต้าโปรเจ็กต์อยู่แล้ว
  • ประมาณการการใช้โควต้าของรหัสไคลเอ็นต์
    • สำหรับแต่ละบริการ ให้ตรวจสอบทั้งความละเอียดต่อวินาทีและความละเอียดต่อวัน
    • กราฟต่อวินาที: คูณการเข้าชมสูงสุดด้วย 60 เพื่อให้ได้โควต้าต่อนาทีเพิ่มเติม
    • กราฟต่อวัน: การเข้าชมสูงสุดควรเป็นโควต้าเพิ่มเติมต่อวันที่จำเป็น
  • ปรับโควต้าในบริการ Maps Platform ที่เกี่ยวข้อง
    • ปรับโควต้าในบริการที่เกี่ยวข้องตามชื่อวิธีการที่คุณพบในขั้นตอนที่ 1

อัปเดตรหัส

แทนที่พารามิเตอร์ไคลเอ็นต์ด้วยพารามิเตอร์คีย์

อัปเดตข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์จาก URL&client={value} เป็น URL&key={value} ในการเรียก GMP API ขาออก หากแอปใช้ HTTP เพื่อเข้าถึงบริการ GMP ให้อัปเดตแอปให้ใช้ HTTPS

อัปเดตพารามิเตอร์ช่องสำหรับการรายงาน

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

ดูข้อมูลเพิ่มเติมได้ที่การรายงานของ Google Maps Platform

นำพารามิเตอร์ลายเซ็นสำหรับบริการบนเว็บออก

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

  • Directions API (เดิม)
  • Distance Matrix API (เดิม)
  • Geocoding API
  • Elevation API
  • Time Zone API

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของแพ็กเกจ Premium

ข้อมูลลับในการลงนามสำหรับ Imagery API

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

ตรวจสอบการเข้าชมรหัสไคลเอ็นต์

หลังจากการติดตั้งใช้งาน ให้ยืนยันว่าการเข้าชมได้ย้ายข้อมูลสำเร็จแล้ว โดยใช้แดชบอร์ดของ Cloud Console คุณจะเริ่มเห็นการเข้าชมที่ใช้ Client-ID ลดลง ซึ่งจะแสดงในรูปแบบ "project_number:123456" ในแดชบอร์ดเมื่อจัดกลุ่มตามข้อมูลเข้าสู่ระบบ

หยุดรหัสไคลเอ็นต์ชั่วคราว

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

การแก้ปัญหา

เราจะดูได้อย่างไรว่าคำขอของเราล้มเหลวหรือไม่

คุณสามารถตรวจสอบสถิติข้อผิดพลาดได้ในกราฟรหัสการตอบกลับ

ข้อผิดพลาด ApiNotActivatedMapError หรือ REQUEST_DENIED

คุณจะเห็นข้อผิดพลาด ApiNotActivatedMapError หรือ REQUEST_DENIED หากไม่ได้เปิดใช้บริการในโปรเจ็กต์ Cloud ทำตามวิธีการเพื่อเปิดใช้บริการ

ข้อผิดพลาด RefererNotAllowedMapError รายการ

คุณจะเห็นข้อผิดพลาด RefererNotAllowedMapError หากไม่ได้เพิ่มโดเมนแหล่งที่มาลงในคีย์ API ดูส่วน "รักษาคีย์ API ให้ปลอดภัย" แล้วเพิ่มโดเมนลงในคีย์ API

ข้อผิดพลาด OverQuotaMapError หรือ OVER_QUERY_LIMIT

คุณจะเห็น OverQuotaMapError หรือ OVER_QUERY_LIMIT หากโควต้าที่คุณกำหนดค่าไว้ไม่เพียงพอต่อการรองรับการเข้าชม ดูส่วน "ตรวจสอบการตั้งค่าโควต้า" แล้วปรับโควต้าตามนั้น

ข้อผิดพลาด "คำขอไปยัง API นี้ต้องผ่าน SSL"

หากได้รับข้อความแสดงข้อผิดพลาดต่อไปนี้ ให้อัปเดตคำขอ API จาก "http://" เป็น "https://"

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}