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