نسخه آزمایشی Places SDK برای iOS در GitHub که به همراه Places SDK برای iOS ارائه شده است، تعدادی از ویژگی‌ها از جمله Place Autocomplete و Place Photos را نشان می‌دهد. علاوه بر این، می‌توانید قطعه کدهایی را در هر صفحه از این راهنمای توسعه‌دهندگان پیدا کنید. برنامه را وارد کرده و بسازید، کلید API خود را اضافه کنید، نسخه آزمایشی را مشاهده کنید و از کد نمونه ارائه شده به عنوان نقطه شروع برای برنامه خود استفاده کنید.
وقتی برنامه نمونه را اجرا می‌کنید، فهرستی از نمونه‌های موجود که می‌توانید روی دستگاه خود اجرا کنید، نمایش داده می‌شود. یکی از گزینه‌ها را انتخاب کنید.
اجرای کامل برنامه نمونه به صورت محلی
برنامه نمونه Places SDK برای iOS به صورت یک آرشیو دانلود از GitHub در دسترس است. برای نصب و امتحان کردن برنامه نمونه Places SDK برای iOS، این مراحل را دنبال کنید.
- آرشیو نمونه کد را از گیت‌هاب دانلود کنید و آن را از حالت فشرده خارج کنید. روش دیگر، کپی کردن مخزن در یک دایرکتوری محلی است:
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن گسترش داده‌اید بروید و به دایرکتوری GooglePlaces بروید:
سویفت
cd maps-sdk-for-ios-samples/GooglePlaces-Swift/
open GooglePlacesSwiftXCFrameworkDemos.xcodeprojهدف-سی
cd maps-sdk-for-ios-samples/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- در پروژه Xcode، به File > Add Package Dependencies بروید. آدرس https://github.com/googlemaps/ios-places-sdk را به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
- کیت توسعه نرم‌افزار Places برای iOS را برای پروژه کنسول Google Cloud خود فعال کنید.
- یک کلید API از پروژه خود با Places API و/یا Places API (جدید) فعال دریافت کنید.
- فایل
SDKDemoAPIKeyرا ویرایش کنید و کلید API خود را در ثابت مناسب قرار دهید. برای مثال:سویفت
let placesAPIKey = "YOUR_API_KEY"
هدف-سی
static NSString *const kAPIKey = @"YOUR_API_KEY";
- اگر Xcode از شما خواست که فایل
SDKDemoAPIKeyرا برای ویرایش از حالت قفل خارج کنید، گزینه Unlock را انتخاب کنید. - در صورت وجود، خط زیر را حذف کنید، زیرا برای ثبت مشکل استفاده شده است:
سویفت
#error (Register for API Key and insert here. Then delete this line.)
هدف-سی
#error Register your API key and insert here, then delete this line. - برنامه را بسازید .
- اگر ساخت با شکست مواجه شد یا برنامه هنگام اجرای اولیه با خطایی در مورد کلید API شما از کار افتاد، مطمئن شوید که کلیدهای مورد نیاز را در فایل
SDKDemoAPIKeyارائه کرده‌اید. - اگر نمونه‌های GooglePlaces را اجرا می‌کنید، پنجره شبیه‌ساز iOS فهرستی از Places Demos را نشان می‌دهد.
- اگر از شما خواسته شد که به GooglePlacesDemos اجازه دسترسی به موقعیت مکانی خود را بدهید، Allow را انتخاب کنید.
- نمونه‌ای که انتخاب کرده‌اید اکنون آماده اجرا است.