استخدام خدمة الأماكن وواجهة برمجة التطبيقات Geocoding API مع أنماط تستند إلى البيانات للحدود

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

يمكنك استخدام خدمة الأماكن وواجهة برمجة التطبيقات Geocoding API مع تطبيق Maps SDK لنظام التشغيل Android للبحث عن المناطق والحصول على مزيد من المعلومات حول الأماكن. إنّ خدمة Places API و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.

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

إنّ خدمة تفاصيل المكان في حزمة تطوير برامج "الأماكن" لنظام التشغيل 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

يمكنك استخدام عكس الترميز الجغرافي للعثور على أرقام تعريف الأماكن. في المثال التالي، تعرض دالة Geocoding 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