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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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

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

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

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

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

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

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

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

يستخدم العرض الترويجي التالي خدمة ترميز المواقع الجغرافية من خلال واجهة برمجة التطبيقات 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 Client وPython Client وGo Client وNode.js Client لخدمات Google Maps هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونماذج الرموز البرمجية.

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