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

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

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

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

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

استخدام Places API

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

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

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

  • تسري أيضًا بيانات "تفاصيل المكان" لمنطقة. يمكنك مثلاً:

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

استخدام Geocoding API

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

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

    يستخدم المثال التالي عنوانًا (تمت إزالة الأحرف الخاصة من عنوان URL) لتقديم طلب إلى Geocoding API:

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

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

    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

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

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