หน้านี้จะอธิบายขั้นตอนพื้นฐานที่จำเป็นในการเริ่มใช้ API และ SDK ใน Google Maps Platform
คู่มือเริ่มใช้งานฉบับย่อ
หากคุณไม่เคยใช้คอนโซล Google Cloud เพื่อสร้างบัญชีสำหรับการเรียกเก็บเงินหรือโปรเจ็กต์ ให้คลิกปุ่มเริ่มต้นใช้งานที่ลิงก์ไปยังประสบการณ์การตั้งค่าแบบอินเทอร์แอกทีฟในคอนโซล Cloud สำหรับผู้ใช้ใหม่ ดังนี้
เริ่มต้นใช้งานหรือจะทำตามขั้นตอนการตั้งค่าที่จำเป็นต่อไปนี้ก็ได้
ขั้นตอนที่ 1: ตั้งค่าโปรเจ็กต์
คอนโซล
-
ในคอนโซล Google Cloud ในหน้าตัวเลือกโปรเจ็กต์ ให้คลิกสร้างโปรเจ็กต์เพื่อเริ่มสร้างโปรเจ็กต์ Cloud ใหม่
-
ตรวจสอบว่าได้เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์แล้ว ยืนยันว่าเปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์แล้ว
Google Cloud มีช่วงทดลองใช้แบบไม่มีค่าใช้จ่าย ช่วงทดลองใช้จะหมดอายุเมื่อสิ้นสุด 90 วันหรือหลังจากที่บัญชีมีค่าใช้จ่ายสะสมถึง $300 แล้วแต่ว่ากรณีใดจะเกิดขึ้นก่อน ยกเลิกได้ทุกเมื่อ ดูข้อมูลเพิ่มเติมได้ที่เครดิตบัญชีสำหรับการเรียกเก็บเงินและการเรียกเก็บเงิน
Cloud SDK
gcloud projects create "PROJECT"
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
ขั้นตอนที่ 2: เปิดใช้ API หรือ SDK
หากต้องการใช้ Google Maps Platform คุณต้องเปิดใช้ API หรือ SDK ที่วางแผนจะใช้กับโปรเจ็กต์
โปรดทราบว่าการผสานรวมบางรายการกำหนดให้คุณต้องเปิดใช้ API/SDK หลายรายการ หากไม่แน่ใจว่าควรเปิดใช้ API หรือ SDK ใด ให้ลองใช้ Capabilities Explorer หรือดูเอกสารประกอบสำหรับ API/SDK ที่ต้องการใช้
วิธีเปิดใช้ API หรือ SDK อย่างน้อย 1 รายการ
คอนโซล
-
ดู API และ SDK ของ Google Maps Platform ที่คุณเปิดใช้ได้โดยไปที่หน้าคลัง Maps API ในคอนโซล Cloud ดังนี้
ไปที่หน้าคลัง Maps API
- คลิก API หรือ SDK ที่ต้องการเปิดใช้
- หากปุ่มระบุว่าเปิดใช้ ให้คลิกปุ่มเพื่อเปิดใช้ API หรือ SDK
- หากปุ่มระบุว่าจัดการ แสดงว่า API หรือ SDK เปิดใช้อยู่แล้ว และคุณไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม
- การคลิกปุ่มใดปุ่มหนึ่งจะแสดงแดชบอร์ดสำหรับ API หรือ SDK (คลิกปุ่มปิดใช้เพื่อนำ API หรือ SDK ออกจากโปรเจ็กต์นี้)
Cloud SDK
คำสั่งต่อไปนี้จะเปิดใช้ Maps, Routes และ Places API ทั้งหมด
gcloud services enable \ --project "PROJECT" \ "addressvalidation.googleapis.com" \ "areainsights.googleapis.com" \ "tile.googleapis.com" \ "aerialview.googleapis.com" \ "elevation-backend.googleapis.com" \ "routes.googleapis.com" \ "geocoding-backend.googleapis.com" \ "geolocation.googleapis.com" \ "maps-android-backend.googleapis.com" \ "maps-backend.googleapis.com" \ "maps-embed-backend.googleapis.com" \ "maps-ios-backend.googleapis.com" \ "mapsplatformdatasets.googleapis.com" \ "places-backend.googleapis.com" \ "roads.googleapis.com" \ "routeoptimization.googleapis.com" \ "static-maps-backend.googleapis.com" \ "street-view-image-backend.googleapis.com" \ "timezone-backend.googleapis.com"
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
ใช้คำสั่งนี้เพื่อเปิดใช้ Environment API
gcloud services enable \ --project "PROJECT" \ "airquality.googleapis.com" \ "solar.googleapis.com" \ "pollen.googleapis.com" \ "weather.googleapis.com"
ขั้นตอนที่ 3: รับคีย์ API
ขั้นตอนนี้จะอธิบายเฉพาะกระบวนการสร้างคีย์ API เท่านั้น หากคุณใช้คีย์ API ในเวอร์ชันที่ใช้งานจริง เราขอแนะนำอย่างยิ่งให้จำกัดคีย์ API ดูข้อมูลเพิ่มเติมได้ในหน้าการใช้คีย์ API เฉพาะผลิตภัณฑ์
คีย์ API คือตัวระบุที่ไม่ซ้ำกันซึ่งตรวจสอบสิทธิ์คำขอที่เชื่อมโยงกับโปรเจ็กต์ของคุณเพื่อวัตถุประสงค์ด้านการใช้งานและการเรียกเก็บเงิน คุณต้องมีคีย์ API อย่างน้อย 1 คีย์ที่เชื่อมโยงกับโปรเจ็กต์ หากต้องการสร้างคีย์ใหม่หรือเพิ่ม API หรือ SDK ลงในคีย์ที่มีอยู่ ให้ทำตามวิธีการต่อไปนี้
คอนโซล
-
ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ
- หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์
-
ทำสิ่งใดสิ่งหนึ่งต่อไปนี้
-
สร้างคีย์ใหม่:
- คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
- ในแผงสร้างคีย์ API ให้เปิดรายการเลือกข้อจำกัดของ API
- ล้าง API ที่คีย์นี้ไม่จำเป็นต้องใช้ และตรวจสอบว่า API ที่คุณวางแผนจะใช้ยังคงเลือกอยู่
- คลิกสร้าง แผงจะแสดงคีย์ API ใหม่
-
ใช้คีย์ที่มีอยู่
- คลิกชื่อคีย์
- ในรายการเลือกข้อจำกัดของ API ให้เลือก API ที่คุณวางแผนจะใช้
- คลิกบันทึก
การเลือก API ที่นี่ไม่ได้เป็นการเปิดใช้ API ตรวจสอบว่า API แต่ละรายการที่คุณเลือกเปิดใช้อยู่ในคลัง API
-
- หากต้องการดูสตริงคีย์ในภายหลัง ให้ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ แล้วคลิกแสดงคีย์สำหรับคีย์นั้น
หากคอนโซลดูแตกต่างจากขั้นตอนเหล่านี้ โปรดดูหัวข้อสร้างคีย์ API และเพิ่มข้อจำกัด API ในเอกสารประกอบของ Google Cloud
Cloud SDK
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ในคำสั่งต่อไปนี้
-
สร้างคีย์ใหม่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ DISPLAY_NAME ด้วยชื่อคีย์ แทนที่ SERVICE_NAME ด้วยชื่อบริการของ API ที่คุณวางแผนจะใช้ เช่น
places.googleapis.comหากต้องการอนุญาต API เพิ่มเติม ให้ทำซ้ำแฟล็ก--api-targetgcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=SERVICE_NAME
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
-
ใช้คีย์ที่มีอยู่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ KEY_ID ด้วยรหัสของคีย์ แทนที่ SERVICE_NAME ด้วยชื่อบริการของ API ที่จะเพิ่ม แฟล็ก
--appendจะเก็บ API ที่คีย์อนุญาตไว้แล้ว หากไม่มีตัวเลือกนี้ คำสั่งจะแทนที่ตัวเลือกเหล่านั้นgcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=SERVICE_NAME
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ 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"
เครดิตบัญชีสำหรับการเรียกเก็บเงิน
- หากคุณไม่เคยเป็นลูกค้าที่ชำระเงินของ Google Cloud, Google Maps Platform หรือ Firebase และไม่เคยลงชื่อสมัครใช้ช่วงทดลองใช้ Google Cloud ฟรีมาก่อน คุณจะมีสิทธิ์รับช่วงทดลองใช้ฟรีและเครดิตต้อนรับมูลค่า $300 ซึ่งคุณสามารถใช้กับบริการของ Google Maps Platform ได้
- SKU ของ Google Maps Platform แต่ละรายการจะให้การใช้งานรายเดือนฟรีในปริมาณที่เฉพาะเจาะจง ซึ่งแสดงอยู่ในรายการราคาและอธิบายไว้ในการเรียกเก็บเงินของ Google Maps Platform
- นอกจากนี้ Google ยังมอบเครดิตสำหรับโปรแกรมสาธารณะ เช่น องค์กรการกุศล สตาร์ทอัพ การรับมือภาวะวิกฤต สื่อข่าว การศึกษา และบริษัทขนส่ง
ขั้นตอนถัดไป
เมื่อตั้งค่าเสร็จแล้ว คุณจะเริ่มใช้ API และ SDK ของ Google Maps Platform ได้ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวม คู่มือสำหรับนักพัฒนาซอฟต์แวร์ และคู่มือเริ่มต้นใช้งานสำหรับ API หรือ SDK ที่คุณสนใจ API และ SDK จะแสดงอยู่ใน เอกสารประกอบของ Google Maps Platform (ตามผลิตภัณฑ์) และ API ของ Google Maps Platform (ตามแพลตฟอร์ม)