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 نقطة نهاية للبحث عن وجهات تتيح لك استرداد معلومات تفصيلية حول وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل عنوان أو معرّف مكان أو إحداثيات خطوط الطول والعرض. يتضمّن الرد ملخّصات مستندة إلى الذكاء الاصطناعي ورموز مميّزة لنقاط التنقّل تحتوي على معلومات سياقية يمكن تمريرها إلى Navigation 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 في مرحلة معاينة ما قبل الإصدار العام، ولا يتم تحصيل أي رسوم مقابل استخدام واجهة برمجة التطبيقات خلال فترة المعاينة. ستظهر طلبات البيانات من واجهة برمجة التطبيقات في صفحة "الفوترة" في Cloud Console، ولكن ستكون الرسوم 0 دولار أمريكي.
الملاحظات
هذه ميزة معاينة. يُرجى إرسال ملاحظاتك إلى geocoding-feedback-channel@google.com.