Geocoding API هي خدمة تقبل مكانًا كعنوان أو إحداثيات خطوط العرض والطول أو رقم تعريف المكان. وتحوّل هذه الخدمة العنوان إلى إحداثيات خطوط العرض والطول ورقم تعريف المكان، أو تحوّل إحداثيات خطوط العرض والطول أو رقم تعريف المكان إلى عنوان.
الإجراءات التي يمكنك تنفيذها باستخدام Geocoding API
يمكنك استخدام Geocoding API للحصول على بيانات الترميز الجغرافي لعنوان واحد أو أكثر أو لأماكن، بما في ذلك ما يلي:
يتضمّن هذا الإصدار من Geocoding API v4 طرح نقاط النهاية التالية:
- الترميز الجغرافي للعنوان — الإحداثيات الجغرافية للعناوين يُعرف أيضًا باسم الترميز الجغرافي الأمامي.
- الترميز الجغرافي لموقع جغرافي — عناوين لمجموعات من إحداثيات خطوط العرض والطول. يُعرف هذا الإجراء أيضًا باسم عكس الترميز الجغرافي.
- الترميز الجغرافي للمكان — استرداد عنوان من رقم تعريف المكان.
- البحث عن وجهات — يمكنك البحث عن وجهة من عنوان أو رقم تعريف مكان أو موقع جغرافي.
يمكنك التحكّم في مكان ظهور النتائج وحصرها في منطقة أو مقاطعة أو رمز بريدي معيّن.
تجربة العرض التوضيحي
طريقة عمل Geocoding API
تتيح Geocoding API إمكانية الترميز الجغرافي وعكس الترميز الجغرافي:
- الترميز الجغرافي: يحوّل العناوين، مثل "1600 Amphitheatre Parkway, Mountain View, CA"، إلى إحداثيات خطوط الطول والعرض أو معرّفات الأماكن. يمكنك استخدام هذه الإحداثيات لوضع علامات على خريطة، أو لتوسيط الخريطة أو إعادة ضبط موضعها ضمن إطار العرض.
- عكس الترميز الجغرافي: يحوّل إحداثيات خطوط الطول والعرض أو رقم تعريف المكان إلى عنوان يمكن قراءته. يمكنك استخدام العناوين في مجموعة متنوعة من السيناريوهات، بما في ذلك عمليات التسليم أو الاستلام.
يلخّص الجدول التالي الموارد المتاحة من خلال Geocoding API بالإضافة إلى البيانات التي تعرضها كل طريقة.
| موارد البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
|---|---|---|
| الترميز الجغرافي | تعرض هذه السمة العنوان ومكوّناته وأنواعه. اطّلِع على مستندات استجابة الترميز الجغرافي. |
|
| عكس الترميز الجغرافي | تعرض هذه السمة العنوان ومكوّناته وأنواعه. اطّلِع على مستندات ردّ الترميز الجغرافي العكسي. | |
| الترميز الجغرافي للأماكن | تعرض هذه السمة العنوان ومكوّناته وأنواعه. راجِع مستندات الردّ على طلب الترميز الجغرافي الخاص بالأماكن. | |
| البحث عن الوجهة | تعرض هذه الطريقة معلومات تفصيلية عن وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل عنوان أو رقم تعريف المكان أو إحداثيات خطوط الطول والعرض. اطّلِع على مستندات البحث عن وجهات. |
الميزات في الإصدار 4 من Geocoding API
يتضمّن الإصدار 4 من Geocoding API هذه الميزات الجديدة.
طريقة البحث عن الوجهة
تقدّم الإصدار 4 طريقة البحث عن الوجهات التي تتيح لك استرداد معلومات تفصيلية حول وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل عنوان أو رقم تعريف المكان أو إحداثيات خطوط الطول والعرض. يتضمّن الرد ملخّصات مستندة إلى الذكاء الاصطناعي ورموز مميّزة لنقاط التنقّل تحتوي على معلومات سياقية يمكن تمريرها إلى حزمة تطوير البرامج (SDK) للتنقّل لتحديد المسار بدقة.
تم تنفيذه على منصة Google Cloud العادية
يتم تنفيذ الإصدار 4 من Geocoding API على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية مع خيارات أمان محسّنة، مثل OAuth. يوفّر تصميم واجهة برمجة التطبيقات المعيارية هذا مستوى من الاتساق بين واجهات برمجة التطبيقات، ما يحسّن كفاءة التطوير باستخدام الإصدار 4 من Geocoding API.
إضافة دعم بروتوكول OAuth
تتيح الإصدار 4 من Geocoding API استخدام OAuth 2.0 للمصادقة. تتيح Google سيناريوهات OAuth 2.0 الشائعة، مثل سيناريوهات خادم الويب.
إضافة ميزة قناع الحقل
استخدِم أقنعة الحقول لتحديد المعلومات التي يجب أن تعرضها الاستجابة. بالنسبة إلى الطرق الترميز الجغرافي لعنوان والترميز الجغرافي لموقع جغرافي والترميز الجغرافي لمكان، يتم عرض جميع الحقول في عنصر الاستجابة تلقائيًا. بالنسبة إلى طريقة البحث عن وجهات، يجب تحديد قناع حقل في طلب بيانات من واجهة برمجة التطبيقات.
أمان واجهة برمجة التطبيقات
تم تصميم الإصدار 4 من Geocoding API ليكون واجهة برمجة تطبيقات من خادم إلى خادم. تؤدي طلبات العميل المباشرة من جهة العميل من المتصفّح إلى تعريض مفاتيح واجهة برمجة التطبيقات لخطر كبير من السرقة وإساءة الاستخدام، لأنّ قيود برنامج الإحالة الناجحة عبر HTTP لا توفّر الحماية الكافية لنقاط نهاية خدمة الويب.
ننصحك بشدة باستخدام الإصدار 4 من Geocoding API من خادم الخلفية الخاص بك. لمزيد من التفاصيل حول أنماط التنفيذ الآمنة والبدائل لاحتياجات من جهة العميل، يُرجى الاطّلاع على اعتبارات الأمان.