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

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

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

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

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

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

يمكنك استخدام ميزة البحث النصي (جديد) واجهة برمجة تطبيقات REST في 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.

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

تفاصيل المكان في أماكن Google لـ Android تعرض بيانات لمنطقة يمكن مفيدة جدًا. يمكنك مثلاً:

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

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

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

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

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

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