استخدام Places APIs وGeocoding مع تنسيق مستند إلى البيانات للحدود

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

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

يمكنك إضافة واجهة برمجة التطبيقات Places وGeocoding إلى تطبيقات حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من خلال الطُرق التالية:

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

استخدام Places 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