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

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

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

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

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

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

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