Google ปกป้องผลิตภัณฑ์ Google Maps Platform จากการใช้งานที่ไม่ได้รับอนุญาตโดยจำกัดการเรียก API ไว้เฉพาะผู้ที่ให้ข้อมูลรับรองการตรวจสอบสิทธิ์ที่ถูกต้อง ข้อมูลเข้าสู่ระบบเหล่านี้อยู่ในรูปแบบของคีย์ API ซึ่งเป็นสตริงตัวอักษรและตัวเลขที่ไม่ซ้ำกันซึ่งเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงินใน Cloud กับโปรเจ็กต์และ API หรือ SDK ที่เฉพาะเจาะจง
คู่มือนี้แสดงวิธีสร้าง จำกัด และใช้คีย์ API สำหรับ Google Maps Platform
ก่อนเริ่มต้น
ก่อนที่จะเริ่มใช้ Distance Matrix API (เดิม) คุณต้องมีโปรเจ็กต์ที่มีบัญชีสำหรับการเรียกเก็บเงินและเปิดใช้ Distance Matrix API (เดิม) ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าในคอนโซล Cloud
สร้างคีย์ API
คีย์ API คือตัวระบุที่ไม่ซ้ำกันซึ่งตรวจสอบสิทธิ์คำขอที่เชื่อมโยงกับโปรเจ็กต์ของคุณเพื่อวัตถุประสงค์ด้านการใช้งานและการเรียกเก็บเงิน คุณต้องมีคีย์ API อย่างน้อย 1 คีย์ที่เชื่อมโยงกับโปรเจ็กต์ หากต้องการสร้างคีย์ใหม่หรือเพิ่ม API หรือ SDK ลงในคีย์ที่มีอยู่ ให้ทำตามวิธีการต่อไปนี้
คอนโซล
-
ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ
- หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์
-
ทำสิ่งใดสิ่งหนึ่งต่อไปนี้
-
สร้างคีย์ใหม่:
- คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
- ในแผงสร้างคีย์ API ให้เปิดรายการเลือกข้อจำกัดของ API
- ล้าง API ที่คีย์นี้ไม่ต้องการ และตรวจสอบว่าได้เลือก Distance Matrix API ไว้
- คลิกสร้าง แผงจะแสดงคีย์ API ใหม่
-
ใช้คีย์ที่มีอยู่
- คลิกชื่อคีย์
- ในรายการเลือกข้อจำกัดของ API ให้เลือก Distance Matrix API
- คลิกบันทึก
การเลือก API ที่นี่ไม่ได้เป็นการเปิดใช้ API ตรวจสอบว่าได้เปิดใช้ Distance Matrix API ในหน้าคลัง API แล้ว
-
- หากต้องการดูสตริงคีย์ในภายหลัง ให้ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ แล้วคลิกแสดงคีย์สำหรับคีย์นั้น
หากคอนโซลดูแตกต่างจากขั้นตอนเหล่านี้ โปรดดูหัวข้อสร้างคีย์ API และเพิ่มข้อจำกัด API ในเอกสารประกอบของ Google Cloud
gcloud
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ในคำสั่งต่อไปนี้
-
สร้างคีย์ใหม่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ DISPLAY_NAME ด้วยชื่อคีย์
gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=distance-matrix-backend.googleapis.com
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
-
ใช้คีย์ที่มีอยู่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ KEY_ID ด้วยรหัสของคีย์ แฟล็ก
--appendจะเก็บ API ที่คีย์อนุญาตไว้แล้ว หากไม่มีตัวเลือกนี้ คำสั่งจะแทนที่ตัวเลือกเหล่านั้นgcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=distance-matrix-backend.googleapis.com
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
รหัสคีย์ไม่ใช่สตริงคีย์หรือชื่อที่แสดง หากต้องการค้นหา ให้เรียกใช้
gcloud services api-keys list --project="PROJECT_ID"รหัสคือส่วนสุดท้ายของช่องname:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID
หากต้องการดูสตริงคีย์ ให้เรียกใช้ gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID"
จำกัดคีย์ API
Google ขอแนะนำอย่างยิ่งให้คุณจำกัดคีย์ API โดยจำกัดการใช้งานเฉพาะ API ที่จำเป็นสำหรับแอปพลิเคชันของคุณเท่านั้น การจำกัดคีย์ API จะเพิ่มความปลอดภัยให้แอปพลิเคชันโดยปกป้องแอปพลิเคชันจากคำขอที่ไม่ได้รับอนุญาต คุณต้องรับผิดชอบค่าใช้จ่ายที่เกิดจากการละเมิดคีย์ API ที่ไม่จำกัด ดูข้อมูลเพิ่มเติมได้ที่แนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API
วิธีจำกัดคีย์ API
คอนโซล
-
ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ
- เลือกคีย์ API ที่ต้องการตั้งค่าการจำกัด หน้าพร็อพเพอร์ตี้คีย์ API จะปรากฏขึ้น
- ในส่วนข้อจำกัดของคีย์ ให้ตั้งค่าข้อจำกัดต่อไปนี้
- ข้อจำกัดแอปพลิเคชัน:
- หากต้องการยอมรับคำขอจากรายการที่อยู่ IP ของเว็บเซิร์ฟเวอร์ที่คุณระบุ ให้เลือกที่อยู่ IP ในส่วนข้อจำกัดของแอปพลิเคชัน ระบุที่อยู่ IPv4 หรือ IPv6 อย่างน้อย 1 รายการ หรือซับเน็ตโดยใช้รูปแบบ CIDR ที่อยู่ IP ต้องตรงกับที่อยู่ต้นทางที่เซิร์ฟเวอร์ Google Maps Platform ตรวจพบ หากคุณใช้การเปลี่ยนค่าที่อยู่เครือข่าย (NAT) โดยทั่วไปแล้วจะสอดคล้องกับที่อยู่ IP สาธารณะของเครื่อง
- ข้อจำกัด API:
- ในเลือกข้อจำกัดของ API ให้ตรวจสอบว่าได้เลือก Distance Matrix API แล้ว หากไม่อยู่ในรายการ คุณจะต้องเปิดใช้
- คลิกบันทึกเพื่อสรุปการเปลี่ยนแปลง
gcloud
เรียกใช้คำสั่งต่อไปนี้ แทนที่ KEY_ID ด้วยรหัสของคีย์ และ PROJECT_ID ด้วยรหัสโปรเจ็กต์ หากต้องการค้นหารหัสคีย์ ให้เรียกใช้ gcloud services api-keys list --project="PROJECT_ID" รหัสคือส่วนสุดท้ายของช่อง name
gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=distance-matrix-backend.googleapis.com \ --allowed-ips="IP_ADDRESS"
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
เพิ่มคีย์ API ลงในคำขอ
คุณต้องใส่คีย์ API ในคำขอ Distance Matrix API (เดิม) ทุกรายการ ในตัวอย่างต่อไปนี้ ให้แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ
https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY
คุณต้องใช้ HTTPS สำหรับคำขอที่ใช้คีย์ API