يمكنك استخدام "خدمة الأماكن" وGeocoding API مع حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع 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) - الحصول على العنوان المنسّق الذي يتم تحويله إلى "اسم المكان، الولاية، البلد" في منطقة الولايات المتحدة (مثل "أوتوموا، آيوا، الولايات المتحدة الأمريكية")
- الحصول على بيانات مفيدة أخرى، مثل الصور
استخدام Geocoding API
تتيح لك Geocoding API تحويل عنوان إلى إحداثيات خطوط العرض والطول ومعرّف مكان، أو تحويل إحداثيات خطوط العرض والطول أو معرّف مكان إلى عنوان. تتكامل حالات الاستخدام التالية بشكل جيد مع ميزة التنسيق المستند إلى البيانات للحدود:
- استخدِم Geocoding للحصول على إطار العرض لمنطقة.
- طبِّق فلترة المكوّنات على طلب Geocoding للحصول على معرّفات الأماكن للمناطق الإدارية من 1 إلى 4 أو المنطقة أو الرمز البريدي.
- استخدِم الترميز الجغرافي العكسي للعثور على معرّفات الأماكن حسب إحداثيات خطوط العرض والطول، أو حتى لعرض معرّفات الأماكن لجميع المكوّنات في موقع جغرافي معيّن.
يستخدم المثال التالي عنوانًا (تمت إزالة الأحرف الخاصة منه) لإجراء طلب إلى Geocoding API:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEYيمكنك استخدام عكس الترميز الجغرافي للعثور على أرقام تعريف الأماكن. تعرض دالة خدمة Geocoding في المثال التالي معرّفات الأماكن لجميع مكوّنات العنوان عند إحداثيات خطوط العرض والطول المحدّدة:
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