برنامههای نمایشی SDK که با Places SDK برای iOS ارائه میشوند، تعدادی ویژگی از جمله تکمیل خودکار مکان و عکسهای مکان را نشان میدهند. علاوه بر این، میتوانید تکههای کد را در هر صفحه از راهنمای این برنامهنویس بیابید.
دموهای SDK را با استفاده از CocoaPods امتحان کنید
Places SDK برای iOS به عنوان یک CocoaPods در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.
Places SDK برای iOS مجموعهای از برنامههای نمایشی SDK را ارائه میکند که میتوانید با استفاده از دستور pod try
نصب و اجرا کنید:
- GooglePlaces تکمیل خودکار مکان و عکسهای مکان را نشان میدهد.
برای نصب CocoaPods و امتحان Places SDK برای iOS این مراحل را دنبال کنید:
- اگر از قبل ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، آن را روی macOS نصب کنید. برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید.
sudo gem install cocoapods
- فایل های نمونه را با یکی از این دو روش دریافت کنید:
از فایل های GitHub استفاده کنید
- آرشیو نمونه کد را از گیت هاب دانلود کنید و آرشیو را از حالت بسته خارج کنید.
- یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل های نمونه را در آن گسترش داده اید بروید، و به فهرست GooglePlaces بروید:
سریع
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
هدف-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- دستور زیر را اجرا کنید:
pod install
open GooglePlacesDemos.xcworkspace
از CocoaPods نسخه 1.6.1 استفاده کنید
- یک پنجره ترمینال را باز کنید و نسخه 1.6.1:
sudo gem install cocoapods -v1.6.1
را نصب کنید - فایلهای Google Places را با استفاده از Cocoapods:
pod try GooglePlaces
واکشی کنیدCocoaPods مخازن مشخصات شما را به روز می کند، سپس دموی SDK را در یک پروژه موقت Xcode،
GooglePlacesDemos.xcworkspace
باز می کند.
- Places SDK برای iOS را برای پروژه Google Cloud Console خود فعال کنید.
- اگر هنوز کلید API ندارید، دستورالعملها را برای راهاندازی یک پروژه در Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، میتوانید شناسه بسته برنامه خود را مشخص کنید تا مطمئن شوید که فقط برنامه شما میتواند از کلید استفاده کند. شناسه بسته پیشفرض برنامه نمونههای SDK
com.example.GooglePlacesDemos
است. - فایل
SDKDemoAPIKey
را ویرایش کنید و کلید API خود را در ثابت مناسب قرار دهید. مثلا:سریع
let placesAPIKey = "YOUR_API_KEY"
هدف-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- اگر Xcode از شما خواست قفل فایل
SDKDemoAPIKey
را برای ویرایش باز کنید، Unlock را انتخاب کنید. - در صورت وجود، خط زیر را حذف کنید، زیرا برای ثبت مشکل استفاده می شود:
سریع
#error (برای کلید API ثبت نام کنید و در اینجا وارد کنید. سپس این خط را حذف کنید.")
هدف-C
#error Register your API key and insert here, then delete this line.
- دوباره پروژه را بسازید و اجرا کنید.
- اگر ساختن با شکست مواجه شد یا برنامه با یک خطا در مورد کلید API شما هنگام اجرای اولین بار از کار افتاد، مطمئن شوید که کلیدهای مورد نیاز در فایل
SDKDemoAPIKey
را ارائه کرده اید. - اگر دموی GooglePlaces را اجرا میکنید، پنجره شبیهساز iOS فهرستی از دموهای مکانها را نشان میدهد.
- اگر از شما خواسته شد به GooglePlacesDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.
- نمونه ای که انتخاب کردید اکنون آماده اجرا است.
از تکه کدهای راهنمای توسعه دهنده استفاده کنید
هر صفحه در راهنمای توسعهدهنده شامل کدهایی است که ویژگی خاصی از API را نشان میدهد. برای مثال، راهنمای تکمیل خودکار ، دریافت مکان فعلی ، عکسها و سایر صفحات را در این راهنما ببینید.