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

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

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

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

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

استخدام Places API

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

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

الحصول على تفاصيل مكان معيّن

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

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

استخدام واجهة برمجة التطبيقات Geocoding API

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

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

    يستخدم المثال التالي عنوانًا (مع إلغاء عنوان URL) لإرسال طلب إلى Geocoding API:

    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