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

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

مميزات استخدام Geocoding API

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

الإجراءات التي يمكنك تنفيذها باستخدام Geocoding API

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

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

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

طريقة عمل Geocoding API

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

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

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

المراجع

يلخّص الجدول التالي الموارد المتاحة من خلال Geocoding API إلى جانب البيانات التي تعرضها كل نقطة نهاية.

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

طريقة استخدام Geocoding API

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

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

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

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

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