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 Client for Google Maps Services
- برنامج Python العميل لخدمات "خرائط Google"
- Go Client for Google Maps Services
- عميل Node.js لخدمات "خرائط Google"
إنّ Java Client وPython Client وGo Client وNode.js Client لخدمات "خرائط Google" هي مكتبات عملاء متاحة للجميع ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت وعيّنة التعليمات البرمجية.
الخطوات التالية
- بدء استخدام Geocoding API: انتقِل إلى إعداد مشروعك على Google Cloud.
- بدء استخدام نماذج الطلبات والردود: انتقِل إلى طلبات وردود الترميز الجغرافي
- اتّباع أفضل الممارسات: انتقِل إلى أفضل الممارسات المتعلّقة بتحويل العناوين إلى رموز جغرافية.