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

ภาพรวม

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

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

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

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

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

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

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

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

ในคอนโซลระบบคลาวด์ คุณสามารถตรวจสอบสถานะล่าสุดของการใช้งานรหัสไคลเอ็นต์ได้ในหน้าเมตริก Google Maps

ดูรายการบริการ Maps Platform

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

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

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

  1. เปิดหน้าเมตริกใน Cloud Console
  2. เลือกบริการ Maps Platform จากเมนูแบบเลื่อนลง
  3. กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
    • ข้อมูลเข้าสู่ระบบ: เลือก "project_number:<numerical identifier>" เท่านั้น
  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 คุณสามารถย้ายข้อมูล URL ที่มาที่เชื่อถือได้ในรหัสไคลเอ็นต์ไปยังข้อจํากัดของคีย์ API คุณดูรายการ URL ที่มาซึ่งเชื่อถือได้ใน Cloud Console

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

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

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

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

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

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

  1. ตรวจสอบว่าคุณใช้บริการฝั่งไคลเอ็นต์ของ Maps JavaScript API ด้วยรหัสไคลเอ็นต์หรือไม่
    • เปิดหน้าเมตริกใน Cloud Console
    • กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
      • จัดกลุ่มตาม: เมธอดของ API
      • ข้อมูลเข้าสู่ระบบ: เลือก "project_number:<numerical identifier>" เท่านั้น
    • จากนั้นคุณจะเห็นรายการชื่อเมธอดที่มีการเข้าชมในแผนภูมิ "การเข้าชมตามเมธอด 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} ในการเรียก API ของ GMP ขาออก หากแอปใช้ HTTP เพื่อเข้าถึงบริการ GMP ให้อัปเดตแอปให้ใช้ HTTPS

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

สําหรับ Web Service 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 คุณจะเริ่มเห็นว่าการเข้าชมรหัสไคลเอ็นต์ลดลง ซึ่งจะแสดงในรูปแบบ "project_number:123456" ในแดชบอร์ดเมื่อจัดกลุ่มตามข้อมูลเข้าสู่ระบบ

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

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

การแก้ปัญหา

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

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

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

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

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