استخدام واجهات برمجة تطبيقات الأماكن والترميز الجغرافي مع التصميم المستند إلى البيانات للحدود

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

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

• تعرض أداة Places SDK for iOS معلومات حول الأماكن التي تستخدم طلبات HTTP.
• يمكن للفئة CLGeocoder ترميز الترميز الجغرافي وعكسه بشكل ديناميكي من إدخال المستخدم.
• واجهة برمجة تطبيقات الترميز الجغرافي تتيح لك ترميز العناوين الثابتة والمعروفة جغرافيًا.

استخدام Places API

• تعرض ميزة البحث النصي في واجهة برمجة التطبيقات للأماكن معلومات عن مجموعة من الأماكن استنادًا إلى سلسلة، مثل "فطائر في دبي" أو "متاجر الأحذية بالقرب من أوتاوا" أو "شارع 123 الرئيسي". تستجيب الخدمة بقائمة من الأماكن التي تطابق السلسلة النصية وأي تحيز للموقع تم تعيينه.

• توفر خدمة الإكمال التلقائي للأماكن طريقة سهلة للسماح للمستخدمين بالبحث عن المناطق. لعرض النتائج ضمن المنطقة المحددة، اضبط السمة locationRestriction على GMSAutocompleteFilter.

الحصول على تفاصيل مكان خاص بمنطقة معيّنة

• تكون بيانات تفاصيل المكان لمنطقة فعالة أيضًا. على سبيل المثال، يمكنك إجراء ما يلي:

  • ابحث عن معرّفات الأماكن الحدودية بناءً على أسماء الأماكن.
  • احصل على إطار العرض لتكبير إحدى الحدود.
  • احصل على نوع العنصر للحدود (على سبيل المثال، المنطقة المحلية).
  • احصل على العنوان المنسّق، الذي يمكن تنسيقه إلى "اسم المكان، الولاية، البلد" في منطقة الولايات المتحدة (على سبيل المثال، "دبي، الإمارات العربية المتحدة"، الولايات المتحدة).
  • يمكنك الحصول على بيانات مفيدة أخرى، مثل الصور.

استخدام واجهة برمجة تطبيقات الترميز الجغرافي

• تتيح لك واجهة برمجة التطبيقات للترميز الجغرافي تحويل عنوان أو إحداثيات خطي العرض والطول أو معرّف المكان إلى إحداثيات جغرافية، والعكس. تندمج الاستخدامات التالية بشكل جيد مع التصميم المستند إلى البيانات للحدود:

  • يمكنك استخدام الترميز الجغرافي للحصول على إطار عرض لمنطقة معيّنة.
  • طبِّق تصفية المكوّنات على طلب الترميز الجغرافي للحصول على أرقام تعريف الأماكن للمناطق الإدارية من 1 إلى 4، أو المنطقة المحلية، أو الرمز البريدي.
  • استخدِم الترميز الجغرافي العكسي للعثور على معرّفات الأماكن حسب إحداثيات خط العرض وخط الطول، أو حتى عرض معرّفات الأماكن لجميع المكوّنات في موقع جغرافي معيّن.

  يستخدم المثال التالي عنوانًا (تم تجاوزه) لإرسال طلب إلى واجهة برمجة تطبيقات الترميز الجغرافي:

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
  

  يمكنك استخدام الترميز الجغرافي العكسي للعثور على معرّفات الأماكن. يعرض المثال التالي دالة خدمة الترميز الجغرافي معرفات الأماكن لجميع مكونات العنوان في إحداثيات خط العرض وخط الطول المحددة:

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY
  

  استخدِم الترميز الجغرافي العكسي مع فلترة المكوّنات للحصول على مكوّن العنوان لنوع واحد أو أكثر من الأنواع التالية في الموقع الجغرافي المحدَّد:

  • administrativeArea
  • country
  • locality
  • postalCode
  • schoolDistrict

  يوضِّح المثال التالي استخدام خدمة الترميز الجغرافي مع إضافة قيود على المكوّنات باستخدام الترميز الجغرافي العكسي لاسترداد جميع مكوّنات العناوين في الموقع الجغرافي المحدّد للنوع locality:

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY