راه اندازی و نسخه ی نمایشی

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS

این صفحه نحوه‌ی راه‌اندازی کتابخانه‌ی کاربردی برای Maps SDK برای iOS را شرح می‌دهد.

برای امتحان کردن این ابزارها، می‌توانید:

اضافه کردن Maps SDK برای کتابخانه ابزار iOS به یک پروژه Xcode

برای افزودن کتابخانه‌ی کاربردی به فضای کاری Xcode خود، این مراحل را دنبال کنید:

استفاده از مدیر بسته Swift

  1. اگر هنوز پروژه Xcode ندارید، اکنون یکی ایجاد کنید و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه کار هستید، یک پروژه جدید ایجاد کنید و الگوی iOS App را انتخاب کنید. در Xcode 11.7 یا قدیمی تر، یک برنامه تک نمایی ایجاد کنید.)
  2. کیت توسعه نرم‌افزار نقشه‌ها برای iOS را به عنوان یک وابستگی اضافه کنید. برای گزینه‌ها به نصب SDK مراجعه کنید.
  3. در پروژه Xcode خود، به مسیر File -> Swift Packages -> Add Package Dependency بروید.
  4. در پنجره‌ی نمایش داده شده، آدرس URL مخزن Maps SDK for iOS Utility Library به https://github.com/googlemaps/google-maps-ios-utils را وارد کرده و Next را انتخاب کنید.
    • در این مرحله، ممکن است از شما خواسته شود که با حساب GitHub خود احراز هویت کنید. برای ادامه روند، دستورالعمل‌ها را دنبال کنید تا یک توکن دسترسی شخصی GitHub ایجاد کنید.
  5. در پنجره بعدی، گزینه رادیویی Version را انتخاب کنید، از لیست کشویی Up to Next Major Version را انتخاب کنید و آخرین نسخه Maps SDK for iOS Utility Library (برای مثال، "6.0.0") را وارد کنید.
  6. روی منوی کشویی کنار «افزودن به پروژه» کلیک کنید، پروژه خود را انتخاب کنید و «افزودن بسته» را انتخاب کنید.

کلید API را به برنامه خود اضافه کنید

برای دستورالعمل‌های مربوط به تولید کلید API و افزودن آن به پروژه Xcode خود ، به بخش «راه‌اندازی پروژه Xcode» مراجعه کنید.

ساخت و اجرای پروژه

بعد از اینکه کلید API را اضافه کردید، پروژه را بسازید و اجرا کنید.

از یک ابزار کمکی در برنامه خود استفاده کنید

برای اطلاعات بیشتر در مورد استفاده از هر ابزار در برنامه خود، به مستندات مربوط به آن مراجعه کنید:

نصب و اجرای برنامه آزمایشی

کتابخانه ابزار شامل یک برنامه آزمایشی است که می‌توانید آن را نصب کنید و سپس هر ابزار را امتحان کنید.

نصب اپلیکیشن دمو:

استفاده از فایل‌های گیت‌هاب

  1. آرشیو نمونه کد را از گیت‌هاب دانلود کنید و آن را از حالت فشرده خارج کنید. روش دیگر، کپی کردن مخزن در یک دایرکتوری محلی است: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن گسترش داده‌اید بروید و به دایرکتوری نمونه‌های مناسب برای زبانی که می‌خواهید استفاده کنید، مراجعه کنید:

    سویفت 

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    هدف-سی 

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

کلید API را به برنامه آزمایشی اضافه کنید

در بخش Get an API key ، یک کلید API برای برنامه خود ایجاد می‌کنید. اکنون آن کلید را به پروژه Xcode برای برنامه آزمایشی اضافه کنید.

سویفت

کلید API خود را به صورت زیر به AppDelegate.swift خود اضافه کنید:

  1. عبارت import زیر را اضافه کنید: 
    import GoogleMaps
  2. خط زیر را ویرایش کنید تا کلید API خود را بین علامت‌های نقل قول دوتایی قرار دهید: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

هدف-سی

کلید API خود را به صورت زیر به AppDelegate.m خود اضافه کنید:

  1. عبارت import زیر را اضافه کنید: 
    @import GoogleMaps;
  2. خط زیر را ویرایش کنید تا کلید API خود را بین علامت‌های نقل قول دوتایی قرار دهید: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

ساخت و اجرای اپلیکیشن دمو

بعد از اضافه کردن کلید API، پروژه را بسازید و اجرا کنید:

  • اگر از نسخه آزمایشی Swift استفاده می‌کنید، می‌توانید انتخاب کنید که کدام ابزار در برنامه نمایش داده شود.
  • اگر از نسخه آزمایشی Objective-C استفاده می‌کنید، نسخه آزمایشی ابزار خوشه‌بندی نشانگر را مشاهده خواهید کرد. سپس می‌توانید نسخه آزمایشی Objective-C را ویرایش کنید تا هر ابزار را امتحان کنید. برای اطلاعات بیشتر به بخش «افزودن یک ابزار به برنامه خود» در زیر مراجعه کنید.