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. يوفّر تصميم واجهة برمجة التطبيقات المعيارية هذا مستوى من الاتساق بين واجهات برمجة التطبيقات، ما يحسّن من كفاءة التطوير باستخدام Geocoding API v4.
إضافة دعم بروتوكول OAuth
تتيح الإصدار 4 من Geocoding API استخدام OAuth 2.0 للمصادقة. توفّر Google سيناريوهات OAuth 2.0 الشائعة، مثل سيناريوهات خادم الويب.
إضافة ميزة قناع الحقل
استخدِم أقنعة الحقول لتحديد المعلومات التي يجب أن تعرضها الاستجابة. بالنسبة إلى نقاط النهاية ترميز الموقع الجغرافي لعنوان وترميز الموقع الجغرافي لمكان وترميز الموقع الجغرافي لمكان، يتم عرض جميع الحقول في عنصر الردّ تلقائيًا. بالنسبة إلى نقطة النهاية البحث عن وجهات، يجب تحديد قناع حقل في طلب واجهة برمجة التطبيقات.
بدون تكلفة مقابل الاستخدام خلال فترة المعاينة
إنّ الإصدار 4 من Geocoding API في مرحلة معاينة ما قبل الإصدار العام، ولا يتم تحصيل أي رسوم مقابل استخدام واجهة برمجة التطبيقات خلال فترة المعاينة. ستظهر طلبات البيانات من واجهة برمجة التطبيقات في صفحة "الفوترة" في Cloud Console، ولكن ستكون الرسوم 0 دولار أمريكي.
أمان واجهة برمجة التطبيقات
تم تصميم الإصدار 4 من Geocoding API ليكون واجهة برمجة تطبيقات بين الخوادم. تؤدي طلبات العميل المباشرة من جهة المتصفّح إلى تعريض مفاتيح واجهة برمجة التطبيقات لخطر كبير من السرقة وإساءة الاستخدام، لأنّ قيود HTTP Referrer لا توفّر الحماية الكافية لنقاط نهاية خدمة الويب.
ننصحك بشدة باستخدام الإصدار 4 من Geocoding API من خادم الخلفية الخاص بك. لمزيد من التفاصيل حول أنماط التنفيذ الآمنة والبدائل لاحتياجات من جهة العميل، راجِع اعتبارات الأمان.
الملاحظات
هذه ميزة في مرحلة المعاينة. يُرجى إرسال ملاحظاتك إلى geocoding-feedback-channel@google.com.