نظرة عامة على واجهة برمجة التطبيقات للترميز الجغرافي

واجهة برمجة التطبيقات للترميز الجغرافي هي خدمة تقبل مكانًا باعتباره عنوانًا أو إحداثيات خطي العرض والطول أو معرّف مكان. فهي تحوِّل العنوان إلى إحداثيات خط العرض وخط الطول ومعرّف المكان، أو تحوّل إحداثيات خط العرض وخط الطول أو معرّف المكان إلى عنوان.

أسباب استخدام واجهة برمجة تطبيقات الترميز الجغرافي

يمكنك استخدام واجهة برمجة تطبيقات الترميز الجغرافي للموقع الإلكتروني أو التطبيق المتوافق مع الأجهزة الجوّالة عندما تريد استخدام بيانات الترميز الجغرافي داخل الخرائط التي توفّرها إحدى واجهات برمجة تطبيقات "منصة خرائط Google". من خلال واجهة برمجة التطبيقات Geocoding API، يمكنك استخدام العناوين لوضع محدّدات المواقع على الخريطة أو تحويل محدّد موقع على الخريطة إلى عنوان. تم تصميم هذه الخدمة للترميز الجغرافي للعناوين الثابتة المحددة مسبقًا لإدراج محتوى التطبيق على الخريطة.

ما يمكنك فعله باستخدام واجهة برمجة التطبيقات Geocoding API

يمكنك استخدام واجهة برمجة تطبيقات الترميز الجغرافي للحصول على بيانات الترميز الجغرافي لعنوان أو مكان واحد أو أكثر، بما في ذلك ما يلي:

  • الإحداثيات الجغرافية للعناوين.
  • عناوين لمجموعات إحداثيات خطوط الطول والعرض.
  • عناوين لأرقام تعريف الأماكن.

ويمكنك التحكّم في مكان ظهور النتائج وحصرها بمنطقة أو مقاطعة أو رمز بريدي معيّن.

آلية عمل واجهة برمجة التطبيقات Geocoding API

تقوم واجهة برمجة تطبيقات الترميز الجغرافي بالترميز الجغرافي والترميز الجغرافي العكسي:

  • الترميز الجغرافي: لتحويل العناوين مثل "1600 Amphitheatre Parkway, Mountain View, CA" إلى إحداثيات خطوط الطول والعرض أو أرقام تعريف الأماكن. يمكنك استخدام هذه الإحداثيات لوضع العلامات على الخريطة أو لتوسيط الخريطة أو إعادة تحديد موضعها داخل إطار العرض.
  • الترميز الجغرافي العكسي: لتحويل إحداثيات خطوط الطول/العرض أو رقم تعريف المكان إلى عنوان يمكن لشخص عادي قراءته. يمكنك استخدام العناوين لمجموعة متنوعة من الحالات، بما في ذلك عمليات التسليم أو استلام الطلبات.

يستخدم العرض التوضيحي التالي خدمة الترميز الجغرافي من خلال Maps JavaScript API لتوضيح آلية عمل واجهة برمجة التطبيقات Geocoding API. افتح الخريطة في علامة تبويب منفصلة للاطّلاع على مزيد من الخيارات والتفاصيل.

المراجِع

يلخّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات للترميز الجغرافي مع البيانات التي تعرضها كل نقطة نهاية.

موارد البيانات البيانات المعروضة تنسيق الإرجاع
الترميز الجغرافي يعرض العنوان ومكونات العنوان وأنواع العناوين. اطّلِع على النتائج في دليل طلب الترميز الجغرافي والاستجابة له.
  • JSON
  • XML
الترميز الجغرافي العكسي يعرض العنوان ومكونات العنوان وأنواع العناوين. يمكنك الاطّلاع على استجابات الترميز الجغرافي العكسي في دليل طلب الترميز الجغرافي العكسي والاستجابة له.
وضع ترميز جغرافي يعرض العنوان ومكونات العنوان وأنواع العناوين. يمكنك الاطّلاع على استجابات الترميز الجغرافي العكسي في دليل وضع طلب الترميز الجغرافي والاستجابة له.

كيفية استخدام واجهة برمجة التطبيقات Geocoding API

1 بدء الإعداد ابدأ بقراءة إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية.
2 تجربة طلب ترميز جغرافي بعد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار واجهة برمجة التطبيقات للترميز الجغرافي مباشرةً من cURL أو من متصفّح. وستحتاج إلى توفير مَعلمات البحث الصحيحة لعمليات البحث عن العنوان أو المكونات. راجِع مَعلمات الترميز الجغرافي للحصول على التفاصيل.
3 تجربة طلب ترميز جغرافي عكسي أدخِل إحداثيات خط العرض/خط الطول مع مفتاح واجهة برمجة التطبيقات للحصول على مكوّنات العنوان لأقرب عنوان يمكن للإنسان قراءته في هذا الموقع الجغرافي. راجِع طلبات الترميز الجغرافي العكسي لمعرفة التفاصيل.
4 فهم أساسيات الردود تعرض جميع نقاط النهاية في واجهة برمجة التطبيقات Geocoding API البيانات نفسها بتنسيق JSON أو XML. يمكنك الاطّلاع على استجابات الترميز الجغرافي للحصول على شرح للبيانات ورموز الحالة ورسائل الخطأ.
5 أدرِج بيانات الترميز الجغرافي في تطبيقك الخاص. يمكنك استخدام بيانات الترميز الجغرافي للحصول على العناوين من محدِّدات الخريطة أو لتوفير علامات على خريطة استنادًا إلى عنوان معروف.

مكتبات العملاء المتاحة

يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:

إنّ Java Client وPython Client وGo Client وNode.js Client for Google Maps هي مكتبات عملاء مدعومة من المنتدى، ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.

الخطوات التالية