ตั้งค่า

หน้านี้อธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าเพื่อเริ่มสร้างด้วย 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

หากต้องการใช้ 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 อย่างน้อย 1 คีย์ที่เชื่อมโยงกับโปรเจ็กต์

วิธีสร้างคีย์ API

คอนโซล

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

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

  2. ในหน้าข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
    กล่องโต้ตอบสร้างคีย์ API แล้วจะแสดงคีย์ API ที่สร้างขึ้นใหม่
  3. คลิกปิด
    คีย์ API ใหม่จะแสดงในหน้าข้อมูลเข้าสู่ระบบในส่วนคีย์ API
    (อย่าลืมจำกัดคีย์ API ก่อนใช้ในเวอร์ชันที่ใช้งานจริง)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

หากต้องการเปิดใช้ 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 มิติลงในแอปได้