الإعداد والعرض التوضيحي

اختيار النظام الأساسي: Android iOS

توضّح هذه الصفحة كيفية إعداد مكتبة الأدوات لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.

لتجربة هذه الأدوات، يمكنك اتّخاذ أحد الإجراءَين التاليَين:

• ثبِّت مكتبة الأدوات في مشروع Xcode حالي. أضِف هذه الأدوات في مشروعك.
• تثبيت التطبيق التجريبي وتشغيله: التطبيق التجريبي هو مشروع مستقل يحتوي على كل الرموز البرمجية المطلوبة لتجربة الأدوات.

إضافة مكتبة أدوات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS إلى مشروع Xcode

اتّبِع الخطوات التالية لإضافة مكتبة الأدوات إلى مساحة عمل Xcode:

استخدام أداة إدارة حِزم Swift

1. إذا لم يكن لديك مشروع Xcode حتى الآن، أنشئ مشروعًا الآن واحفظه على جهازك. (إذا كنت مبتدئًا في تطوير تطبيقات iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيقات iOS. في Xcode 11.7 أو الإصدارات الأقدم، أنشئ تطبيقًا مزوّدًا بشاشة واحدة.)
2. أضِف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS كعنصر تابع. اطّلِع على تثبيت حزمة SDK لمعرفة الخيارات المتاحة.
3. في مشروع Xcode، انتقِل إلى ملف -> حِزم Swift -> إضافة تبعية حزمة.
4. في النافذة التي تظهر، أدخِل عنوان URL لمستودع "مكتبة الأدوات" لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS https://github.com/googlemaps/google-maps-ios-utils وانقر على التالي.
• في هذه المرحلة، قد يُطلب منك المصادقة باستخدام حسابك على GitHub. اتّبِع التعليمات لإنشاء رمز GitHub شخصي للوصول لمواصلة العملية.
5. في النافذة التالية، اختَر خيار الإصدار، ثم اختَر حتى الإصدار الرئيسي التالي من القائمة المنسدلة، وأدخِل أحدث إصدار من حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS Utility Library (على سبيل المثال، "6.0.0").
6. انقر على القائمة المنسدلة بجانب الإضافة إلى المشروع، واختَر مشروعك، ثمّ انقر على إضافة حزمة.

استخدام CocoaPods

1. إذا لم يكن لديك مشروع Xcode حتى الآن، أنشئ مشروعًا الآن واحفظه على جهازك. (إذا كنت مبتدئًا في تطوير تطبيقات iOS، أنشئ تطبيقًا لعرض ملف واحد).
2. إذا لم يكن لديك ملف pod لمشروعك، أنشئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف تبعيات مشروعك.
3. عدِّل ملف podfile الخاص بمشروعك وأضِف تبعية على ملف Google-Maps-iOS-Utils pod. في ما يلي مثال على الملحقات التي تحتاج إليها لأجل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS ومكتبة الأدوات:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   end

4. شغِّل pod install.
5. أغلِق Xcode، ثم افتح (انقر مرّتين) على ملف .xcworkspace الخاص بمشروعك لتشغيل Xcode. من الآن فصاعدًا، عليك استخدام ملف .xcworkspace لفتح المشروع.

ملاحظة: تعتمد أداة تجميع العلامات على الشكل الرباعي، ولكن يمكنك استخدام الشكل الرباعي بدون تجميع العلامات. إذا كنت تريد استخدام أداة شجرة رباعية الأبعاد فقط، يمكنك تغيير pod 'Google-Maps-iOS-Utils' إلى 'Google-Maps-iOS-Utils/QuadTree' في ملف pod.

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

اطّلِع على مقالة إعداد مشروع Xcode للحصول على تعليمات حول إنشاء مفتاح واجهة برمجة التطبيقات وإضافته إلى مشروع Xcode.

إنشاء المشروع وتشغيله

بعد إضافة مفتاح واجهة برمجة التطبيقات، أنشئ المشروع وشغِّله.

استخدام أداة في تطبيقك

يمكنك الاطّلاع على المستندات المتعلّقة بكل أداة للحصول على مزيد من المعلومات عن استخدامها في تطبيقك:

• تجميع محدّدات المواقع
• Quadtree
• عرض ملفات KML
• عرض GeoJSON
• خريطة الحرارة

تثبيت التطبيق التجريبي وتشغيله

تتضمّن مكتبة الأدوات تطبيقًا تجريبيًا يمكنك تثبيته ثم تجربة كل أداة.

تثبيت التطبيق التجريبي:

استخدام ملفات من GitHub

1. نزِّل أرشيف نماذج الرموز البرمجية من GitHub وفكِّ ضغط الأرشيف.
2. افتح نافذة طرفية وانتقِل إلى الدليل الذي وسّعت فيه ملفّات العيّنات، ثم تنقّل إلى دليل العيّنات المناسب للغة التي تريد استخدامها:
   • بالنسبة إلى Swift، يمكنك تنفيذ cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • بالنسبة إلى Objective-C، يمكنك تنفيذ cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. نفِّذ الأمر التالي:
   

   pod install

4. أغلِق Xcode، ثم افتح (انقر مرّتين) على ملف .xcworkspace الخاص بمشروعك لتشغيل Xcode. من الآن فصاعدًا، عليك استخدام ملف .xcworkspace لفتح المشروع.

إضافة مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي

في قسم الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء مفتاح واجهة برمجة تطبيقات لتطبيقك. أضِف الآن هذا المفتاح إلى مشروع Xcode للتطبيق التجريبي.

ملاحظة: إذا كان مفتاح واجهة برمجة التطبيقات يستخدم قيدًا على التطبيق، احرص على إضافة معرّف الحِزمة لتطبيقك إلى المفتاح. على سبيل المثال، إذا كنت بصدد تشغيل التطبيق التجريبي، يكون معرّف الحِزمة هو com.google.gmsutils.DemoApp. اطّلِع على مقالة الحصول على مفتاح واجهة برمجة التطبيقات للحصول على مزيد من المعلومات حول فرض قيود على مفتاح.

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

1. أضِف بيان الاستيراد التالي:

   import GoogleMaps

2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

1. أضِف بيان الاستيراد التالي:

   @import GoogleMaps;

2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

إنشاء التطبيق التجريبي وتشغيله

بعد إضافة مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء المشروع وتشغيله:

• إذا كنت تستخدم إصدار Swift من الإصدار التجريبي، يمكنك اختيار الأداة التي تريد عرضها في التطبيق.
• إذا كنت تستخدم إصدار Objective-C من العرض التجريبي، سيظهر لك العرض التجريبي لأداة تجميع العلامات. يمكنك بعد ذلك تعديل إصدار Objective-C من العرض التجريبي لتجربة كل أداة. اطّلِع على قسم إضافة أداة إلى تطبيقك أدناه للحصول على مزيد من المعلومات.