نسخه آزمایشی 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/ios-places-sdk-samples.git
یک پنجره ترمینال باز کنید، به دایرکتوری که فایلهای نمونه را در آن گسترش دادهاید بروید و به دایرکتوری مربوط به نسخهای که میخواهید استفاده کنید، مراجعه کنید:
سویفتیوآی
cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeprojسویفت
cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeprojهدف-سی
cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- در پروژه Xcode، به File > Add Package Dependencies بروید. آدرس https://github.com/googlemaps/ios-places-sdk را به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
- کیت توسعه نرمافزار Places برای iOS و کیت توسعه نرمافزار Maps برای iOS را برای پروژه کنسول Google Cloud خود فعال کنید.
- یک کلید API از پروژه خود با Places API و/یا Places API (جدید) فعال دریافت کنید.
- با استفاده از دستورالعملهای مناسب زیر، کلید API خود را به برنامه اضافه کنید.
سویفتیوآی
یک فایل پیکربندی محلی به نام
GooglePlacesDemos.xcconfigبرای کلید API خود، در همان دایرکتوری که فایلInfo.plistبرنامه آزمایشی (GooglePlacesDemos/GooglePlacesDemos) قرار دارد، ایجاد کنید.برای تعریف کلیدهای API خود، دو خط به فایل پیکربندی خود اضافه کنید:
PLACES_API_KEY = YOUR_PLACES_API_KEYوMAPS_API_KEY = YOUR_MAPS_API_KEY.کلیدهای API مراحل قبلی را جایگزین
YOUR_PLACES_API_KEYوYOUR_MAPS_API_KEYکنید.برای راهنمایی در مورد ایجاد یک فایل پیکربندی محلی، به فرمت فایل تنظیمات پیکربندی (xcconfig) مراجعه کنید.
سویفت
فایل
SDKDemoAPIKeyرا ویرایش کنید و کلید API خود را در ثابت مناسب قرار دهید. برای مثال:let placesAPIKey = "YOUR_API_KEY"
در صورت وجود، خط زیر را حذف کنید:
#error (Register for API Key and insert here. Then delete this line.)
اگر Xcode از شما خواست که فایل
SDKDemoAPIKeyرا برای ویرایش از حالت قفل خارج کنید، گزینه Unlock را انتخاب کنید.هدف-سی
فایل
SDKDemoAPIKeyرا ویرایش کنید و کلید API خود را در ثابت مناسب قرار دهید. برای مثال:static NSString *const kAPIKey = @"YOUR_API_KEY";
در صورت وجود، خط زیر را حذف کنید
#error (Register for API Key and insert here. Then delete this line.)اگر Xcode از شما خواست که فایل
SDKDemoAPIKeyرا برای ویرایش از حالت قفل خارج کنید، گزینه Unlock را انتخاب کنید. - برنامه را بسازید .
- اگر ساخت با شکست مواجه شد یا برنامه هنگام اجرای اولیه با خطایی در مورد کلید API شما از کار افتاد، مطمئن شوید که کلیدهای مورد نیاز در دستورالعملهای بالا را ارائه کردهاید.
- اگر برنامه نمونه را اجرا کنید، پنجره شبیهساز iOS فهرستی از Places Demos را نشان میدهد.
- اگر از شما خواسته شد که به برنامه آزمایشی اجازه دسترسی به موقعیت مکانی خود را بدهید، گزینه «اجازه دادن» را انتخاب کنید.
- نمونهای که انتخاب کردهاید اکنون آماده اجرا است.