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

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

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

يمكنك إضافة "خدمة الأماكن" و"ترميز المواقع الجغرافية" إلى حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android بالطُرق التالية:

استخدام "خدمة الأماكن"

استخدام ميزة "البحث عن نص" (جديد) للعثور على معرّف مكان

يمكنك استخدام واجهة برمجة التطبيقات Text Search (New) REST API في Places API للحصول على معرّف مكان يتضمّن بيانات المنطقة من خلال تحديد places.id في قناع الحقل. لا يتم تحصيل أي رسوم مقابل استخدام ميزة البحث النصي (جديد) لطلب معرّفات الأماكن. مزيد من المعلومات

على سبيل المثال، للحصول على معرّف المكان في تريندا، كاليفورنيا، يمكنك إجراء طلب برمجي مما يلي لواجهة برمجة التطبيقات:

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

استخدام ميزة "الإكمال التلقائي للأماكن" للعثور على المناطق

توفّر خدمة الإكمال التلقائي للأماكن في حزمة تطوير البرامج Places SDK لأجهزة Android طريقة ملائمة للسماح للمستخدمين بالبحث عن المناطق. لضبط خدمة "الإكمال التلقائي للأماكن" لعرض مناطق فقط، استخدِم رمز AutocompleteSupportFragment.setTypesFilter(List) لضبط فلتر النوع على PlaceTypes.REGIONS.

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

إنّ خدمة تفاصيل المكان في حزمة تطوير البرامج (SDK) لأماكن Android تعرض بيانات منطقة معيّنة يمكن أن تكون مفيدة للغاية. يمكنك مثلاً:

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

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

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

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

يستخدم المثال التالي عنوانًا (مُشفَّرًا بترميز URL) لتقديم طلب إلى واجهة برمجة التطبيقات Geocoding API:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

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

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

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

  • administrativeArea
  • country
  • locality
  • postalCode

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

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