بررسی اجمالی نمونه کد

پلتفرم را انتخاب کنید: Android iOS JavaScript

برنامه نمایشی SDK ارائه شده با Maps SDK برای iOS شامل نمونه هایی برای ویژگی های برجسته SDK است. کد موجود در برنامه آزمایشی را بررسی کنید تا ببینید هر نمونه چگونه پیاده سازی شده است.

دموهای SDK را امتحان کنید

برنامه نمایشی Maps SDK برای iOS SDK به عنوان یک بایگانی دانلود از GitHub و به عنوان یک CocoaPods pod در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.

این مراحل را دنبال کنید تا برنامه نمایشی Maps SDK for iOS SDK را نصب و امتحان کنید.

  1. فایل های نمونه را با یکی از این دو روش دریافت کنید:

    مستقیماً از GitHub

    1. آرشیو نمونه کد را از گیت هاب دانلود کنید و آرشیو را از حالت بسته خارج کنید.
    2. یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل های نمونه را در آن گسترش داده اید بروید، و به فهرست راهنمای GoogleMaps بروید:

      سریع

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      هدف-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps
    3. دستورات زیر را اجرا کنید:

      سریع

      pod install
open GoogleMapsSwiftDemos.xcworkspace

      هدف-C

      pod install
open GoogleMapsDemos.xcworkspace

    از CocoaPods نسخه 1.6.1 استفاده کنید

    1. اگر از قبل ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، نسخه 1.6.1 را روی macOS نصب کنید. برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید. 
      sudo gem install cocoapods -v1.6.1
    2. فایل‌های Google Maps را با استفاده از Cocoapods: 
      pod try GoogleMaps
      واکشی کنید

      وقتی از شما خواسته شد Swift یا Objective-C را انتخاب کنید. CocoaPods مخازن مشخصات شما را به روز می کند، سپس نسخه آزمایشی را در یک پروژه موقت Xcode به نام SwiftDemoApp.xcodeproj یا ObjCDemoApp.xcodeproj باز می کند.

  2. در Xcode، دکمه کامپایل را فشار دهید تا بسازید و سپس طرح فعلی را اجرا کنید. بیلد یک خطایی ایجاد می‌کند که از شما می‌خواهد کلید API خود را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  3. اگر هنوز کلید API ندارید، دستورالعمل‌ها را برای راه‌اندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، می‌توانید شناسه بسته برنامه خود را مشخص کنید تا مطمئن شوید که فقط برنامه شما می‌تواند از کلید استفاده کند. شناسه بسته پیش‌فرض برنامه نمونه‌های SDK com.example.GoogleMapsDemos است.
  4. فایل SDKConstants.swift را برای Swift یا SDKDemoAPIKey.h برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابت apiKey یا kAPIKey قرار دهید. مثلا:

    سریع

    static let apiKey = "YOUR_API_KEY"

    هدف-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  5. خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:

    سریع

    #error (Register for API Key and insert here. Then delete this line.”)

    هدف-C

    #error Register for API Key and insert here.
  6. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود که فهرستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
  7. یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
  8. اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.

از تکه کدهای راهنمای توسعه دهنده استفاده کنید

هر صفحه در راهنمای توسعه‌دهنده شامل کدهایی است که ویژگی خاصی از API را نشان می‌دهد. برای مثال، راهنمای اشیاء نقشه ، نشانگرها ، اشکال و سایر صفحات را در این راهنما ببینید.