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

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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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

استخدام Places API

  • تعرض خدمة Places API Text Search معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في نيويورك" أو "متاجر أحذية بالقرب من أوتاوا" أو "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