نمونه‌های کد کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS

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

برنامه نمایشی «کیت توسعه نرم‌افزار مکان‌ها ویژه iOS» در GitHub که همراه با «کیت توسعه نرم‌افزار مکان‌ها ویژه iOS» ارائه شده است تعدادی از ویژگی‌ها ازجمله «تکمیل خودکار مکان» و «عکس‌های مکان» را نشان می‌دهد. علاوه‌براین، می‌توانید در هر صفحه از این راهنمای توسعه‌دهنده، تکه‌کد پیدا کنید. برنامه را وارد و بسازید، کلید API خود را اضافه کنید، نسخه نمایشی را مشاهده کنید، و از کد نمونه ارائه‌شده به‌عنوان نقطه شروع برنامه خود استفاده کنید.

وقتی برنامه نمونه را اجرا می‌کنید، فهرستی از نمونه‌های دردسترس را نمایش می‌دهد که می‌توانید در دستگاه خودتان اجرا کنید. یکی از گزینه‌ها را انتخاب کنید.

اجرای برنامه نمونه کامل به‌صورت محلی

برنامه نمونه Places SDK for iOS به‌صورت بایگانی بارگیری‌شدنی از GitHub دردسترس است. برای نصب و امتحان کردن برنامه نمونه Places SDK for iOS، این مراحل را دنبال کنید.

  1. بارگیری بایگانی نمونه کد از GitHub و ازهم بازکردن بایگانی. یا اینکه مخزن را در دایرکتوری محلی شبیه‌سازی کنید: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

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

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    آبجکتیو-سی

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. در پروژه Xcode، به File (فایل) > Add Package Dependencies (افزودن وابستگی‌های بسته) بروید. https://github.com/googlemaps/ios-places-sdk را به‌عنوان نشانی وب وارد کنید، کلید ورود را فشار دهید تا بسته را وارد کنید، و روی افزودن بسته کلیک کنید.
  4. «کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS» را برای پروژه کنسول Google Cloud خود فعال کنید.
  5. از پروژه‌تان با میانای برنامه‌سازی کاربردی Places و/یا میانای برنامه‌سازی کاربردی Places (جدید) فعال کلید میانای برنامه‌سازی کاربردی دریافت کنید.
  6. بااستفاده از دستورالعمل‌های مناسب زیر، کلید API خود را به برنامه اضافه کنید.

    SwiftUI

    فایل پیکربندی محلی به‌نام GooglePlacesDemos.xcconfig برای کلید API خود در همان دایرکتوری فایل Info.plist برنامه نمایشی (GooglePlacesDemos/GooglePlacesDemos) ایجاد کنید.

    خطی به فایل پیکربندی‌تان اضافه کنید تا کلید API خود را تعریف کنید:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    ‫YOUR_PLACES_API_KEY را با کلید API از مراحل قبلی جایگزین کنید.

    برای راهنمایی درباره ایجاد فایل پیکربندی محلی، به قالب فایل تنظیمات پیکربندی (xcconfig) مراجعه کنید.

    Swift

    فایل SDKDemoAPIKey را ویرایش کنید و کلید میانای API خود را در ثابت مناسب جای‌گذاری کنید. برای مثال:

    let placesAPIKey = "YOUR_API_KEY"

    درصورت وجود، خط زیر را بردارید:

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

    اگر Xcode از شما خواست فایل SDKDemoAPIKey را برای ویرایش باز کنید، باز کردن را انتخاب کنید.

    آبجکتیو-سی

    فایل SDKDemoAPIKey را ویرایش کنید و کلید API خود را در ثابت مناسب جای‌گذاری کنید. برای مثال:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    درصورت وجود، خط زیر را بردارید

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

    اگر Xcode از شما خواست قفل فایل SDKDemoAPIKey را برای ویرایش باز کنید، باز کردن قفل را انتخاب کنید.

  7. برنامه را بسازید.
  8. اگر ساختار با خطا مواجه شد یا برنامه با خطایی درباره کلید میانای برنامه‌سازی کاربردی شما ازکار افتاد وقتی برای اولین‌بار آن را اجرا می‌کنید، مطمئن شوید که کلیدهای موردنیاز در دستورالعمل‌های بالا را ارائه کرده‌اید.
  9. اگر برنامه نمونه را اجرا کنید، پنجره شبیه‌ساز iOS فهرستی از «نمونه‌های Places» را نشان خواهد داد.
  10. اگر از شما خواسته شد به برنامه نمایشی اجازه دهید به مکانتان دسترسی داشته باشد، اجازه دادن را انتخاب کنید.
  11. نمونه‌ای که انتخاب کردید اکنون آماده اجرا است.