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

ภาพรวม

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

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

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

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

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

อัปเดตรหัส

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

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

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

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

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

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

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

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

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

Signing Secret สำหรับ Imagery API

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

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

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

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

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

การเปิดใช้งานรหัสไคลเอ็นต์อีกครั้งชั่วคราวแบบบริการตนเอง

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

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

• ไปที่หน้าข้อมูลเข้าสู่ระบบของ Google Maps Platform
• ค้นหาโปรเจ็กต์ Cloud ที่เฉพาะเจาะจงซึ่งลิงก์กับรหัสไคลเอ็นต์
• คลิกไอคอนเลิกหยุดชั่วคราวที่อยู่ทางด้านขวาสุดของรายการเพื่อกู้คืน บริการ

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

• รหัสลูกค้า
• กรณีการใช้งานที่เฉพาะเจาะจง
• วันที่ย้ายข้อมูลเป้าหมาย
• การประเมินผลกระทบทางธุรกิจ

รายงานการใช้งานรหัสไคลเอ็นต์ - จากรายงานการเรียกเก็บเงิน

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

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

1. ไปที่หน้าการเรียกเก็บเงิน > รายงานใน คอนโซล Google Cloud
2. (ไม่บังคับ เกี่ยวข้องกับพาร์ทเนอร์เท่านั้น) ใช้ตัวกรองเพื่อเลือก บัญชีการเรียกเก็บเงินย่อยที่ต้องการ
3. จัดกลุ่มข้อมูลรายงานตามคีย์ป้ายกำกับ goog-maps-api-key-suffix ป้ายกำกับนี้จะแสดงอักขระต่อท้ายของคีย์ API
4. ระบุการเข้าชมรหัสไคลเอ็นต์โดยมองหารายการที่ไม่มีหรือไม่มีป้ายกำกับ goog-maps-api-key-suffix เนื่องจากระบบจะไม่สร้างป้ายกำกับนี้สำหรับคำขอรหัสไคลเอ็นต์
5. ไม่สนใจ SKU ที่ไม่ได้มีไว้เพื่อเชื่อมโยงกับคำขอ API เช่น SKU การสมัครใช้บริการ

การแก้ปัญหา

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

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

ข้อผิดพลาด 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"
}