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

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

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

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

استخدام Places Service

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

يمكنك استخدام البحث النصي (جديد) 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'

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

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

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

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

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

استخدام Geocoding API

تتيح لك 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

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

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