ตั้งค่า Roads API

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

หากที่อยู่สำหรับการเรียกเก็บเงินของคุณอยู่ในเขตเศรษฐกิจยุโรป ตั้งแต่วันที่ 8 กรกฎาคม 2025 เป็นต้นไป ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA จะมีผลบังคับใช้กับการใช้บริการของคุณ ฟังก์ชันการทำงานจะแตกต่างกันไปตามภูมิภาค ดูข้อมูลเพิ่มเติม

เอกสารนี้อธิบายขั้นตอนที่คุณต้องทำเพื่อเริ่มใช้ Roads API

ข้อกำหนดเบื้องต้น

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

1. ตรวจสอบการเรียกเก็บเงินและค่าใช้จ่ายสำหรับการใช้งานที่Roads API การใช้งานและการเรียกเก็บเงิน

2. ตรวจสอบว่าคุณมีบัญชี Google Cloud

   ลงชื่อเข้าใช้คอนโซล Google Cloud
   หมายเหตุ: หากคุณเป็นผู้ใช้ใหม่และไม่มีบัญชี Google Cloud ซึ่งหมายความว่าคุณไม่สามารถลงชื่อเข้าใช้คอนโซลได้ โปรดดูหัวข้อการเริ่มต้นใช้งาน Google Maps Platform

3. ยืนยันว่าคุณมีโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน

   ไปที่หน้าการเรียกเก็บเงิน
   หมายเหตุ: หากคุณเป็นผู้ใช้ใหม่และไม่มีโปรเจ็กต์ Google Cloud โปรดดูหัวข้อการเริ่มต้นใช้งาน Google Maps Platform
1. เลือกโปรเจ็กต์เพื่อเปิดหน้าการเรียกเก็บเงิน

2. ในหน้าการเรียกเก็บเงิน ให้ทำดังนี้

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

เปิดใช้ API

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

หมายเหตุ: หลังจากเปิดใช้ API คุณอาจต้องรอ 2-3 นาทีก่อนจึงจะส่งคำขอไปยัง API ได้

วิธีเปิดใช้ API

คอนโซล

1. เปิดหน้าผลิตภัณฑ์ในคอนโซล Google Cloud โดยทำดังนี้

   เปิดใช้ Roads API

2. คลิกปุ่มเปิดใช้

   หมายเหตุ: หากเปิดใช้ API อยู่แล้ว คุณจะเห็นปุ่มจัดการแทนปุ่มเปิดใช้

gcloud

gcloud services enable \
    --project "PROJECT" \
    "roads.googleapis.com"

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

• gcloud services enable
• gcloud services disable

รับคีย์ API เพื่อใช้กับ Roads API

ผลิตภัณฑ์ Google Maps Platform ได้รับการปกป้องจากการใช้งานที่ไม่ได้รับอนุญาตโดยกำหนดให้การเรียก API ต้องมีคีย์ API

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

คอนโซล

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

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

2. หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์

3. ทำสิ่งใดสิ่งหนึ่งต่อไปนี้

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

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

   • ใช้คีย์ที่มีอยู่

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

   การเลือก API ที่นี่ไม่ได้เป็นการเปิดใช้ API ตรวจสอบว่าได้เปิดใช้ Roads 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=roads.googleapis.com

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

  • gcloud services api-keys create

• ใช้คีย์ที่มีอยู่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ KEY_ID ด้วยรหัสของคีย์ แฟล็ก --append จะเก็บ API ที่คีย์อนุญาตไว้แล้ว หากไม่มีตัวเลือกนี้ คำสั่งจะแทนที่ตัวเลือกเหล่านั้น

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=roads.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  รหัสคีย์ไม่ใช่สตริงคีย์หรือชื่อที่แสดง หากต้องการค้นหา ให้เรียกใช้ 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

ส่งคำขอ Roads API เพื่อแสดงผลการตอบกลับ JSON ที่จัดตำแหน่งจุดที่ระบุให้ตรงกับเรขาคณิตของถนน คุณต้องใส่สตริงตัวอักษรและตัวเลขคละกันของคีย์ API ในทุกคำขอ และใช้ HTTPS สำหรับคำขอที่มีคีย์ API

1. คลิก API_KEY ในโค้ดด้านล่างเพื่อแทรกสตริงตัวอักษรและตัวเลขคละกันของคีย์

   curl -L -X GET 'https://roads.googleapis.com/v1/snapToRoads?path=-35.27801%2C149.12958%7C-35.28032%2C149.12907%7C-35.28099%2C149.12929%7C-35.28144%2C149.12984%7C-35.28194%2C149.13003%7C-35.28282%2C149.12956%7C-35.28302%2C149.12881%7C-35.28473%2C149.12836&interpolate=true&key=YOUR_API_KEY'
   

2. คลิกไอคอนคัดลอกในตัวอย่างโค้ด เพื่อคัดลอกคำสั่ง curl
3. วางคำสั่งในหน้าต่างเทอร์มินัลและเรียกใช้คำสั่ง

การตอบกลับเป็นออบเจ็กต์ JSON ในรูปแบบต่อไปนี้

{
  "snappedPoints": [
    {
      "location": {
        "latitude": -35.278004899930188,
        "longitude": 149.129531998742
      },
      "originalIndex": 0,
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    {
      "location": {
        "latitude": -35.2784195,
        "longitude": 149.12946589999999
      },
      "placeId": "ChIJr_xl0GdNFmsRsUtUbW7qABM"
    },
    ...
    {
      "location": {
        "latitude": -35.284727644851415,
        "longitude": 149.12833853807396
      },
      "originalIndex": 7,
      "placeId": "ChIJtWxAZmpNFmsRlbUCkc6VtnA"
    }
  ]
}

ใช้ข้อจำกัดของคีย์ API

ข้อควรระวัง: คีย์ API ที่ไม่จำกัดสามารถใช้เพื่อส่งคำขอไปยังบริการใดก็ได้ของ Google Maps Platform รวมถึง Roads API คุณต้องรับผิดชอบค่าใช้จ่ายที่เกิดจากการละเมิดคีย์ API ที่ไม่จำกัด

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ข้อจำกัดได้ที่จำกัดคีย์ API

ขั้นตอนถัดไป

เมื่อเปิดใช้ Roads API และส่งคำขอสำเร็จแล้ว โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ API ที่หัวข้อ Snap to Roads