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

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

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

إضافة خدمة الأماكن والترميز الجغرافي إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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'

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

الإكمال التلقائي للأماكن في حزمة تطوير برامج الأماكن لأجهزة 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

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

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