Geocoding API هي خدمة تقبل مكانًا كعنوان أو إحداثيات خطوط العرض والطول أو رقم تعريف المكان. وتحوّل هذه الواجهة العنوان إلى إحداثيات خطوط العرض والطول ورقم تعريف المكان، أو تحوّل إحداثيات خطوط العرض والطول أو رقم تعريف المكان إلى عنوان.
الإجراءات التي تتيح Geocoding API تنفيذها
يمكنك استخدام Geocoding API للحصول على بيانات الترميز الجغرافي لعنوان واحد أو أكثر أو مكان واحد أو أكثر، بما في ذلك ما يلي:
- الإحداثيات الجغرافية للعناوين
- عناوين لمجموعات من إحداثيات خطوط العرض والطول
- عناوين أرقام تعريف الأماكن
يمكنك التحكّم في مكان ظهور النتائج وحصرها في منطقة أو مقاطعة أو رمز بريدي معيّن.
طريقة عمل Geocoding API
تنفّذ Geocoding API كلاً من الترميز الجغرافي وعكس الترميز الجغرافي:
- الترميز الجغرافي: يحوّل العناوين، مثل "1600 Amphitheatre Parkway, Mountain View, CA"، إلى إحداثيات خطوط العرض وخطوط الطول أو أرقام تعريف الأماكن. يمكنك استخدام هذه الإحداثيات لوضع علامات على الخريطة أو لتوسيط الخريطة أو تغيير موضعها ضمن إطار العرض.
- عكس الترميز الجغرافي: يحوّل إحداثيات خطوط العرض/الطول أو رقم تعريف المكان إلى عنوان يمكن لشخص عادي قراءته. يمكنك استخدام العناوين في مجموعة متنوعة من السيناريوهات، بما في ذلك عمليات التسليم أو الاستلام.
يستخدم العرض التوضيحي التالي خدمة الترميز الجغرافي من خلال Maps JavaScript API لتوضيح آلية عمل Geocoding API. افتح الخريطة في علامة تبويب منفصلة للاطّلاع على المزيد من الخيارات والتفاصيل.
الموارد
يلخّص الجدول التالي الموارد المتاحة من خلال Geocoding API، بالإضافة إلى البيانات التي تعرضها كل طريقة.
| مصادر البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
|---|---|---|
| الترميز الجغرافي | تعرض هذه الدالة العنوان ومكوّناته وأنواعه. اطّلِع على النتائج في دليل طلب الترميز الجغرافي والردّ عليه. |
|
| عكس الترميز الجغرافي | تعرض هذه الدالة العنوان ومكوناته وأنواعه. يمكنك الاطّلاع على الردود على طلبات عكس الترميز الجغرافي في دليل طلبات عكس الترميز الجغرافي والردود عليها. | |
| الترميز الجغرافي للأماكن | تعرض هذه الدالة العنوان ومكوناته وأنواعه. يمكنك الاطّلاع على الردود على طلبات عكس الترميز الجغرافي في دليل طلبات الترميز الجغرافي للأماكن والردود عليها. |
كيفية استخدام Geocoding API
| 1 | إعداد الميزة: | ابدأ بإعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية. |
| 2 | تجربة طلب ترميز جغرافي | بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار Geocoding API مباشرةً من curl أو من متصفّح. يجب تقديم مَعلمات البحث الصحيحة لعمليات البحث عن العناوين أو المكوّنات. لمزيد من التفاصيل، يُرجى الاطّلاع على مَعلمات الترميز الجغرافي. |
| 3 | تجربة طلب عكس الترميز الجغرافي | أدخِل إحداثيات خطوط العرض والطول مع مفتاح واجهة برمجة التطبيقات للحصول على مكوّنات العنوان لأقرب عنوان يمكن لشخص عادي قراءته لهذا الموقع الجغرافي. لمزيد من التفاصيل، يُرجى الاطّلاع على طلبات عكس الترميز الجغرافي. |
| 4 | التعرّف على أساسيات الردود | تعرض جميع الطرق في Geocoding API البيانات نفسها بتنسيق JSON أو XML. يُرجى الاطّلاع على ردود الترميز الجغرافي للحصول على شرح للبيانات ورموز الحالة ورسائل الخطأ. |
| 5 | يمكنك دمج بيانات الترميز الجغرافي في تطبيقك الخاص. | يمكنك استخدام بيانات الترميز الجغرافي للحصول على العناوين من علامات الخريطة أو لتوفير علامات على خريطة استنادًا إلى عنوان معروف. |
مكتبات العملاء المتاحة
يمكنك طلب بيانات واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات البرامج التالية:
- برنامج Java التابع لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- Go Client for Google Maps Services
- عميل Node.js لخدمات "خرائط Google"
إنّ عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google" هي مكتبات عملاء يدعمها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت والرمز النموذجي.
الخطوات التالية
- بدء استخدام Geocoding API: انتقِل إلى إعداد مشروعك على Google Cloud.
- البدء باستخدام نماذج الطلبات والردود: انتقِل إلى طلبات الترميز الجغرافي والردود عليها
- اتّباع أفضل الممارسات: انتقِل إلى أفضل الممارسات المتعلّقة بالعناوين في الترميز الجغرافي.