ตั้งค่า

หน้านี้อธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าเพื่อเริ่มสร้างด้วย Maps 3D SDK สำหรับ iOS ขั้นตอนการตั้งค่าประกอบด้วยการกำหนดค่าโปรเจ็กต์ Google Cloud และ API เพื่อใช้กับ SDK จากนั้นจึงตั้งค่าโปรเจ็กต์ Xcode ทำตามขั้นตอนเหล่านี้ก่อนเพิ่มแผนที่ 3 มิติแรกลงในแอป

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

หากต้องการใช้ Maps 3D SDK สำหรับ iOS โปรเจ็กต์และอุปกรณ์เป้าหมายของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • เวอร์ชัน iOS ขั้นต่ำ: กำหนดเป้าหมายเป็น iOS 16.0 ขึ้นไป
  • Xcode: Xcode เวอร์ชัน 16.0 ขึ้นไป

ตั้งค่าโปรเจ็กต์ Google Cloud และคีย์ API

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

ขั้นตอนที่ 1: ตั้งค่าโปรเจ็กต์

คอนโซล

  1. ในคอนโซล Google Cloud ในหน้าตัวเลือกโปรเจ็กต์ ให้คลิกสร้างโปรเจ็กต์เพื่อเริ่มสร้างโปรเจ็กต์ Cloud ใหม่

    ไปที่หน้าตัวเลือกโปรเจ็กต์

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

    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 รายการ

คอนโซล

  1. ดู API และ SDK ของ Google Maps Platform ที่คุณเปิดใช้ได้โดยไปที่หน้าคลัง Maps API ในคอนโซล Cloud ดังนี้

    ไปที่หน้าคลัง Maps API

  2. คลิก 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 ลงในคีย์ที่มีอยู่ ให้ทำตามวิธีการต่อไปนี้

คอนโซล

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

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

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

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

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

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

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

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

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

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

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

Cloud SDK

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

  • สร้างคีย์ใหม่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ DISPLAY_NAME ด้วยชื่อคีย์ แทนที่ SERVICE_NAME ด้วยชื่อบริการของ API ที่คุณวางแผนจะใช้ เช่น places.googleapis.com หากต้องการอนุญาต API เพิ่มเติม ให้ทำซ้ำแฟล็ก --api-target

    gcloud 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"

หากต้องการเปิดใช้ SDK โปรดดูหน้า Maps 3D SDK สำหรับ iOS ในคอนโซล Google Cloud ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำตามขั้นตอนเหล่านี้ได้ที่การเริ่มต้นใช้งาน Google Maps Platform

ตั้งค่าโปรเจ็กต์ Xcode

ส่วนนี้จะอธิบายวิธีสร้างและกำหนดค่าโปรเจ็กต์ Xcode เพื่อใช้กับ Maps 3D SDK สำหรับ iOS

หลังจากเปิดใช้การเรียกเก็บเงินและสร้างคีย์ API แล้ว คุณก็พร้อมที่จะตั้งค่าโปรเจ็กต์ Xcode ที่ใช้พัฒนาแอป

ขั้นตอนที่ 1: ติดตั้งซอฟต์แวร์ที่จำเป็น

หากต้องการสร้างโปรเจ็กต์โดยใช้ Maps 3D SDK สำหรับ iOS คุณต้องดาวน์โหลดและติดตั้งสิ่งต่อไปนี้

  • Xcode เวอร์ชัน 16.0 ขึ้นไป

ขั้นตอนที่ 2: สร้างโปรเจ็กต์ Xcode และติดตั้ง Maps 3D SDK สำหรับ iOS

Swift Package Manager

คุณติดตั้ง Maps 3D SDK สำหรับ iOS ได้โดยใช้ Swift Package Manager

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  • เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
  • ป้อน https://github.com/googlemaps/ios-maps-3d-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
  • จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าระบบจะเพิ่ม GoogleMaps3D ลงในเป้าหมายหลักที่กำหนดไว้ เมื่อเสร็จแล้ว ให้คลิกเพิ่มแพ็กเกจ
  • หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ นอกจากนี้ คุณยังดูส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

ขั้นตอนที่ 3: เพิ่มคีย์ API ลงในแอป

Swift Package Manager

เพิ่มคีย์ API ลงในจุดแรกเข้าหลักของแอป (หรือเมื่อใดก็ได้ก่อนที่แผนที่จะโหลด) ดังนี้

  1. เพิ่มคำสั่งนำเข้าต่อไปนี้ 
    import GoogleMaps3D
  2. เพิ่มเมธอดต่อไปนี้ แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

ขั้นตอนที่ 4 (ไม่บังคับ): ตรวจสอบไฟล์ Apple Privacy Manifest

Apple กำหนดให้ต้องระบุรายละเอียดความเป็นส่วนตัวของแอปสำหรับแอปใน App Store

ไฟล์ Apple Privacy Manifest รวมอยู่ในแพ็กเกจทรัพยากรสำหรับ SDK หากต้องการยืนยันว่าได้รวมไฟล์ไฟล์ Manifest ด้านความเป็นส่วนตัวแล้ว และตรวจสอบเนื้อหา ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร

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

เมื่อตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google, คีย์ API และโปรเจ็กต์ Xcode สำหรับใช้กับ Maps 3D SDK สำหรับ iOS แล้ว คุณสามารถเพิ่มแผนที่ 3 มิติลงในแอปได้