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