Geocoding API هي خدمة تقبل مكانًا كعنوان أو إحداثيات خطوط العرض والطول أو رقم تعريف المكان. وتحوّل هذه الواجهة العنوان إلى إحداثيات خطوط العرض والطول ورقم تعريف المكان، أو تحوّل إحداثيات خطوط العرض والطول أو رقم تعريف المكان إلى عنوان.
الإجراءات التي تتيح Geocoding API تنفيذها
يمكنك استخدام Geocoding API للحصول على بيانات الترميز الجغرافي لعنوان أو مكان واحد أو أكثر، بما في ذلك ما يلي:
يتضمّن هذا الإصدار من Geocoding API v4 طرح نقاط النهاية التالية:
- الترميز الجغرافي لعنوان — الإحداثيات الجغرافية للعناوين ويُعرف أيضًا باسم الترميز الجغرافي الأمامي.
- الترميز الجغرافي لموقع جغرافي — عناوين لمجموعات من إحداثيات خطوط العرض وخطوط الطول ويُعرف ذلك أيضًا باسم عكس الترميز الجغرافي.
- الترميز الجغرافي للأماكن — يمكنك استرداد عنوان من رقم تعريف مكان.
- البحث عن وجهات: يمكنك البحث عن وجهة من خلال عنوان أو رقم تعريف مكان أو موقع جغرافي.
يمكنك التحكّم في مكان ظهور النتائج وحصرها في منطقة أو مقاطعة أو رمز بريدي معيّن.
تجربة العرض التوضيحي
طريقة عمل Geocoding API
تنفّذ Geocoding API كلاً من الترميز الجغرافي وعكس الترميز الجغرافي:
- الترميز الجغرافي: يحوّل العناوين، مثل "1600 Amphitheatre Parkway, Mountain View, CA"، إلى إحداثيات خطوط العرض والطول أو أرقام تعريف الأماكن. يمكنك استخدام هذه الإحداثيات لوضع علامات على الخريطة، أو لتوسيط الخريطة أو تغيير موضعها داخل إطار العرض.
- عكس الترميز الجغرافي: تحويل إحداثيات خطوط العرض والطول أو رقم تعريف المكان إلى عنوان يمكن لشخص عادي قراءته يمكنك استخدام العناوين في مجموعة متنوعة من السيناريوهات، بما في ذلك عمليات التسليم أو الاستلام.
يلخّص الجدول التالي الموارد المتاحة من خلال Geocoding API والبيانات التي تعرضها كل طريقة.
| مصادر البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
|---|---|---|
| الترميز الجغرافي | تعرض هذه الدالة العنوان ومكوّناته وأنواعه. اطّلِع على مستندات استجابة الترميز الجغرافي. |
|
| عكس الترميز الجغرافي | تعرض هذه الدالة العنوان ومكوناته وأنواعه. اطّلِع على مستندات الاستجابة لعكس الترميز الجغرافي. | |
| الترميز الجغرافي للأماكن | تعرض هذه الدالة العنوان ومكوّناته وأنواعه. اطّلِع على مستندات الاستجابة للترميز الجغرافي للمكان. | |
| البحث عن الوجهات | تعرض هذه الدالة معلومات تفصيلية عن وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل العنوان أو رقم تعريف المكان أو إحداثيات خطوط العرض والطول. يُرجى الاطّلاع على مستندات البحث عن الوجهات. |
إطلاق قنوات Stage
يحتوي الإصدار 4 من Geocoding API على قنوات منفصلة للميزات المتاحة للجميع والميزات الحصرية والميزات التجريبية. إذا أردت استخدام ميزات "المعاينة" أو "التجريبية"،
احرص على تحديد القناة الصحيحة في طلبك. على سبيل المثال،
للوصول إلى ميزات نقطة نهاية "الوجهات" في الإصدار التجريبي، استخدِم طلب HTTP
التالي: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| مرحلة الإطلاق | اسم القناة |
|---|---|
| GA | /v4/ |
| نسخة حصرية | /v4beta/ |
| تجريبي | /v4alpha/ |
- يمكنك الاطّلاع على مرجع REST للحصول على قائمة بجميع موارد REST المتاحة ووصف لها.
- يمكنك الاطّلاع على مراحل الإطلاق لمزيد من المعلومات عن كل مرحلة.
الميزات في الإصدار 4 من Geocoding API
يوفّر الإصدار 4 من Geocoding API هذه الميزات الجديدة.
طريقة البحث عن الوجهة
يقدّم الإصدار الرابع طريقة بحث عن الوجهات تتيح لك استرداد معلومات تفصيلية عن وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل العنوان أو رقم تعريف المكان أو إحداثيات خطوط العرض والطول. يتضمّن الردّ ملخّصات مستندة إلى الذكاء الاصطناعي ورموز مميّزة لنقاط التنقّل تحتوي على معلومات سياقية يمكن تمريرها إلى حزمة تطوير البرامج (SDK) للتنقّل من أجل تحديد المسار بدقة.
تم تنفيذها على منصة Google Cloud العادية
يتم تنفيذ الإصدار 4 من Geocoding API على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية مع خيارات أمان محسّنة مثل OAuth. يوفّر تصميم واجهة برمجة التطبيقات العادي هذا مستوى من الاتساق في جميع واجهات برمجة التطبيقات، ما يحسّن كفاءة التطوير باستخدام الإصدار 4 من Geocoding API.
تمت إضافة دعم OAuth
يتيح الإصدار 4 من Geocoding API استخدام OAuth 2.0 للمصادقة. تتيح Google سيناريوهات OAuth 2.0 الشائعة، مثل تلك الخاصة بخادم الويب.
إضافة ميزة قناع الحقل
استخدِم أقنعة الحقول لتحديد المعلومات التي يجب أن يعرضها الردّ. بالنسبة إلى الطرق Geocode an address وGeocode a location وPlace geocoding، يتم تلقائيًا عرض جميع الحقول في عنصر الاستجابة. بالنسبة إلى طريقة البحث عن الوجهات، يجب تحديد قناع حقل في طلب البيانات من واجهة برمجة التطبيقات.
أمان واجهة برمجة التطبيقات
تم تصميم الإصدار 4 من Geocoding API كواجهة برمجة تطبيقات بين الخوادم. تؤدي الطلبات المباشرة من جهة العميل من المتصفّح إلى تعريض مفاتيح واجهة برمجة التطبيقات لخطر كبير يتمثل في السرقة وإساءة الاستخدام، لأنّ القيود المفروضة على مُحيل HTTP لا توفّر حماية كافية لنقاط نهاية خدمة الويب.
ننصحك بشدة باستدعاء Geocoding API v4 من خادمك الخلفي. لمزيد من التفاصيل حول أنماط التنفيذ الآمن والبدائل لاحتياجات من جهة العميل، يُرجى الاطّلاع على اعتبارات الأمان.