يمكنك استخدام خدمة "الأماكن" وواجهة برمجة التطبيقات Geocoding API مع حزمة SDK لتطبيق "خرائط Google" لأجهزة Android للبحث عن المناطق، و الحصول على مزيد من المعلومات عن الأماكن. خدمة "الأماكن" وGeocoding API هما بدائل قوية وثابتة للحصول على أرقام تعريف الأماكن. إذا كنت تستخدم أرقام تعريف أماكن، يمكنك إعادة استخدام أرقام تعريف الأماكن هذه مع تصميم مستند إلى البيانات للحدود.
إضافة خدمة الأماكن والترميز الجغرافي إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android بالطرق التالية:
- حزمة تطوير البرامج (SDK) للأماكن لنظام Android: هي مكتبة Android تحتوي على طُرق لعرض معلومات عن الأماكن.
- Places API يعرض معلومات حول الأماكن باستخدام طلبات HTTP.
- فئة "المشفِّر الجغرافي" يمكنها الترميز الجغرافي وعكس الترميز الجغرافي بشكل ديناميكي من إدخال المستخدم.
- Geocoding API: الترميز الجغرافي للعناوين الثابتة والمعروفة.
استخدام خدمة "الأماكن"
استخدام ميزة "البحث النصي" (جديد) للعثور على معرّف مكان
يمكنك استخدام ميزة البحث النصي (جديد)
واجهة برمجة تطبيقات 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 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