يمكنك استخدام "خدمة الأماكن" وGeocoding API مع Maps SDK لأجهزة Android للبحث عن المناطق والحصول على مزيد من المعلومات عن الأماكن. "خدمة الأماكن" وGeocoding API هما بديلان قويّان وموثوقان للحصول على أرقام تعريف الأماكن. إذا كنت تستخدم حاليًا أرقام تعريف الأماكن، يمكنك إعادة استخدامها مع ميزة التنسيق المستند إلى البيانات للحدود.
أضِف خدمة الأماكن والترميز الجغرافي إلى حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android في ما يلي من طرق:
- Places SDK لأجهزة Android هي مكتبة Android تحتوي على طرق لعرض معلومات عن الأماكن.
- Places API تعرض Places API معلومات عن الأماكن باستخدام طلبات HTTP.
- يمكن لفئة Geocoder إجراء عملية الترميز الجغرافي والترميز الجغرافي العكسي بشكلٍ ديناميكي من بيانات أدخلها المستخدم.
- تتيح لك Geocoding API إجراء عملية الترميز الجغرافي لعناوين ثابتة ومعروفة.
استخدام "خدمة الأماكن"
استخدام ميزة "البحث النصي" (الجديدة) للعثور على رقم تعريف مكان
يمكنك استخدام البحث النصي (جديد) 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.
الحصول على تفاصيل مكان لمنطقة
يمكن أن تكون خدمة تفاصيل المكان في Places SDK لأجهزة Android مفيدة جدًا لعرض بيانات منطقة. يمكنك مثلاً:
- البحث عن أرقام تعريف الأماكن التي تمثّل الحدود استنادًا إلى أسماء الأماكن
- الحصول على إطار العرض للتكبير/التصغير على حدّ
- الحصول على نوع الميزة للحدّ (مثل
locality) - الحصول على العنوان المنسّق الذي يتم تحويله إلى "اسم المكان، الولاية، البلد" في منطقة الولايات المتحدة (مثل "Ottumwa, IA, USA")
- الحصول على بيانات مفيدة أخرى، مثل الصور
استخدام Geocoding API
تتيح لك Geocoding API تحويل عنوان إلى إحداثيات خطوط العرض والطول ورقم تعريف مكان، أو تحويل إحداثيات خطوط العرض والطول أو رقم تعريف مكان إلى عنوان. تتكامل حالات الاستخدام التالية بشكلٍ جيد مع ميزة التنسيق المستند إلى البيانات للحدود:
- استخدِم Geocoding للحصول على إطار العرض لمنطقة.
- طبِّق فلترة المكوّنات على طلب Geocoding للحصول على أرقام تعريف الأماكن للمناطق الإدارية من 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استخدِم الترميز الجغرافي العكسي مع فلترة المكوّنات للحصول على مكوّن العنوان لنوع واحد أو أكثر من الأنواع التالية في الموقع الجغرافي المحدّد:
administrativeAreacountrylocalitypostalCode
تعرض دالة المثال التالي استخدام خدمة Geocoding، وإضافة قيود على المكوّنات باستخدام عكس الترميز الجغرافي للحصول على جميع مكوّنات العنوان في الموقع الجغرافي المحدّد لنوع locality فقط:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY