ใช้คีย์ API กับ Directions API (เดิม)

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

ดูวิธีสร้าง จำกัด และใช้คีย์ API สำหรับ Google Maps Platform

ก่อนเริ่มต้น

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

สร้างคีย์ API

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

คอนโซล

  1. ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ

    ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ

  2. หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์
  3. ทำสิ่งใดสิ่งหนึ่งต่อไปนี้

    • สร้างคีย์ใหม่:

      1. คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
      2. ในแผงสร้างคีย์ API ให้เปิดรายการเลือกข้อจำกัดของ API
      3. ล้าง API ที่คีย์นี้ไม่จำเป็นต้องใช้ และตรวจสอบว่าได้เลือก Directions API ไว้
      4. คลิกสร้าง แผงจะแสดงคีย์ API ใหม่
    • ใช้คีย์ที่มีอยู่

      1. คลิกชื่อคีย์
      2. ในรายการเลือกข้อจำกัดของ API ให้เลือก Directions API
      3. คลิกบันทึก

    การเลือก API ที่นี่ไม่ได้เป็นการเปิดใช้ API ตรวจสอบว่าได้เปิดใช้ Directions API ในหน้าคลัง API แล้ว

  4. หากต้องการดูสตริงคีย์ในภายหลัง ให้ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ แล้วคลิกแสดงคีย์สำหรับคีย์นั้น

หากคอนโซลดูแตกต่างจากขั้นตอนเหล่านี้ โปรดดูหัวข้อสร้างคีย์ API และเพิ่มข้อจำกัด API ในเอกสารประกอบของ Google Cloud

gcloud

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ในคำสั่งต่อไปนี้

  • สร้างคีย์ใหม่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ DISPLAY_NAME ด้วยชื่อคีย์

    gcloud services api-keys create \
        --project="PROJECT_ID" \
        --display-name="DISPLAY_NAME" \
        --api-target=service=directions-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=directions-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

คอนโซล

  1. ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ

    ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ

  2. เลือกคีย์ API ที่ต้องการตั้งค่าการจำกัด หน้าพร็อพเพอร์ตี้คีย์ API จะปรากฏขึ้น
  3. ในส่วนข้อจำกัดของคีย์ ให้ตั้งค่าข้อจำกัดต่อไปนี้
    • ข้อจำกัดแอปพลิเคชัน:
      1. หากต้องการยอมรับคำขอจากรายการที่อยู่ IP ของเว็บเซิร์ฟเวอร์ที่คุณระบุ ให้เลือกที่อยู่ IP ในส่วนข้อจำกัดของแอปพลิเคชัน ระบุที่อยู่ IPv4 หรือ IPv6 อย่างน้อย 1 รายการ หรือซับเน็ตโดยใช้รูปแบบ CIDR ที่อยู่ IP ต้องตรงกับที่อยู่ต้นทางที่เซิร์ฟเวอร์ Google Maps Platform ตรวจพบ หากคุณใช้การเปลี่ยนค่าที่อยู่เครือข่าย (NAT) โดยทั่วไปแล้วจะสอดคล้องกับที่อยู่ IP สาธารณะของเครื่อง
    • ข้อจำกัด API:
      1. ในเลือกข้อจำกัด API ให้ตรวจสอบว่าได้เลือก Directions API แล้ว หากไม่อยู่ในรายการ คุณจะต้องเปิดใช้
  4. คลิกบันทึกเพื่อสรุปการเปลี่ยนแปลง

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=directions-backend.googleapis.com \
    --allowed-ips="IP_ADDRESS"

อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

เพิ่มคีย์ API ลงในคำขอ

คุณต้องใส่คีย์ API ไว้ในคำขอ Directions API (เดิม) ทุกรายการ ในตัวอย่างต่อไปนี้ ให้แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY

สำหรับคำขอที่ใช้คีย์ API คุณต้องใช้ HTTPS