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