برنامه نمایشی SDK ارائه شده با Maps SDK برای iOS شامل نمونه هایی برای ویژگی های برجسته SDK است. کد موجود در برنامه آزمایشی را بررسی کنید تا ببینید هر نمونه چگونه پیاده سازی شده است.
دموهای SDK را امتحان کنید
برنامه نمایشی Maps SDK برای iOS SDK به عنوان یک بایگانی دانلود از GitHub و به عنوان یک CocoaPods pod در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.
این مراحل را دنبال کنید تا برنامه نمایشی Maps SDK for iOS SDK را نصب و امتحان کنید.
- فایل های نمونه را با یکی از این دو روش دریافت کنید:
مستقیماً از GitHub
- آرشیو نمونه کد را از گیت هاب دانلود کنید و آرشیو را از حالت بسته خارج کنید.
- یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل های نمونه را در آن گسترش داده اید بروید، و به فهرست راهنمای GoogleMaps بروید:
سریع
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
هدف-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
- دستورات زیر را اجرا کنید:
سریع
pod install open GoogleMapsSwiftDemos.xcworkspace
هدف-C
pod install open GoogleMapsDemos.xcworkspace
از CocoaPods نسخه 1.6.1 استفاده کنید
- اگر از قبل ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، نسخه 1.6.1 را روی macOS نصب کنید. برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید.
sudo gem install cocoapods -v1.6.1
- فایلهای Google Maps را با استفاده از Cocoapods:
pod try GoogleMaps
واکشی کنیدوقتی از شما خواسته شد Swift یا Objective-C را انتخاب کنید. CocoaPods مخازن مشخصات شما را به روز می کند، سپس نسخه آزمایشی را در یک پروژه موقت Xcode به نام
SwiftDemoApp.xcodeproj
یاObjCDemoApp.xcodeproj
می کند.
- در Xcode، دکمه کامپایل را فشار دهید تا بسازید و سپس طرح فعلی را اجرا کنید. بیلد یک خطایی ایجاد میکند که از شما میخواهد کلید API خود را در فایل
SDKConstants.swift
برای Swift یا فایلSDKDemoAPIKey.h
برای Objective-C وارد کنید. - اگر هنوز کلید API ندارید، دستورالعملها را برای راهاندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، میتوانید شناسه بسته برنامه خود را مشخص کنید تا مطمئن شوید که فقط برنامه شما میتواند از کلید استفاده کند. شناسه بسته پیشفرض برنامه نمونههای SDK
com.example.GoogleMapsDemos
است. - فایل
SDKConstants.swift
را برای Swift یاSDKDemoAPIKey.h
برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابتapiKey
یاkAPIKey
قرار دهید. مثلا:سریع
static let apiKey = "YOUR_API_KEY"
هدف-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:
سریع
#error (Register for API Key and insert here. Then delete this line.”)
هدف-C
#error Register for API Key and insert here.
- پروژه را بسازید و اجرا کنید. پنجره شبیهساز iOS ظاهر میشود که فهرستی از نسخههای نمایشی Maps SDK را نشان میدهد.
- یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
- اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.
از تکه کدهای راهنمای توسعه دهنده استفاده کنید
هر صفحه در راهنمای توسعهدهنده شامل کدهایی است که ویژگی خاصی از API را نشان میدهد. برای مثال، راهنمای اشیاء نقشه ، نشانگرها ، اشکال و سایر صفحات را در این راهنما ببینید.