Geocoding API هي خدمة تقبل مكانًا كعنوان أو إحداثيات خطوط العرض والطول أو رقم تعريف المكان. وتحوّل هذه الواجهة العنوان إلى إحداثيات خطوط العرض والطول ورقم تعريف المكان، أو تحوّل إحداثيات خطوط العرض والطول أو رقم تعريف المكان إلى عنوان.
يوفّر الإصدار 4 من Geocoding API كلاً من معلومات الوصول والوجهة على مستوى منطقة محلية صغيرة ودقة تحويل الإحداثيات إلى عناوين. سواء كنت بصدد إنشاء تجربة توصيل في المرحلة الأخيرة أو مشاركة الرحلات أو اتجاهات مفصّلة أو تسوية عناوين الشوارع إلى إحداثيات، يوفّر الإصدار 4 نقاط نهاية مخصّصة لحالة الاستخدام.
ألست متأكدًا من نقطة النهاية المناسبة لتطبيقك؟ يُرجى الاطّلاع على اختيار طريقة ترميز جغرافي.
الإجراءات التي تتيح Geocoding API تنفيذها
يتضمّن الإصدار 4 من Geocoding API الإمكانات ونقاط النهاية التالية:
- البحث عن الوجهات: يمكنك استرداد تفاصيل الوصول إلى وجهة معيّنة على مستوى منطقة محلية صغيرة من خلال عنوان أو رقم تعريف مكان أو إحداثيات، بما في ذلك مداخل المباني ورموز نقاط التنقّل القابلة للتوجيه ومخططات المباني والأراضي والوجهات الفرعية والمعالم القريبة.
- الترميز الجغرافي لعنوان: يمكنك تحويل عناوين الشوارع إلى إحداثيات جغرافية وأرقام تعريف الأماكن (الترميز الجغرافي الأمامي).
- الترميز الجغرافي لموقع جغرافي: يمكنك تحويل إحداثيات خطوط العرض والطول إلى عناوين شوارع أو مناطق إدارية يمكن لشخص عادي قراءتها (عكس الترميز الجغرافي).
- الترميز الجغرافي لمكان: يمكنك استرداد تفاصيل العنوان المنسَّق والإحداثيات لرقم تعريف مكان معروف على "خرائط Google".
يمكنك التحكّم في مكان ظهور النتائج وحصرها في منطقة أو مقاطعة أو رمز بريدي معيّن.
تجربة العرض التوضيحي
طريقة عمل Geocoding API
يتيح الإصدار 4 من Geocoding API البحث عن الوجهات إلى جانب الترميز الجغرافي الأساسي:
- البحث عن الوجهة (
SearchDestinations): يحلّل عنوانًا أو رقم تعريف مكان أو زوج إحداثيات في عنصرDestinationغني. استخدِم هذه الطريقة عندما يكون الوصول الفعلي مهمًا، مثل تحديد مداخل المباني المفضّلة، أو توجيه السائقين إلى نقاط محدّدة للركوب أو النزول باستخدام رموز نقاط التنقّل، أو عرض مساحات المباني على خريطة، أو التنقّل في مجمّعات متعدّدة المباني. - الترميز الجغرافي الأساسي: يحوّل العناوين والإحداثيات وأرقام تعريف الأماكن:
- الترميز الجغرافي: يحوّل عناوين الشوارع، مثل "1600 Amphitheatre Parkway, Mountain View, CA"، إلى إحداثيات خطوط العرض وخطوط الطول أو أرقام تعريف الأماكن لوضع علامات على الخريطة أو توسيط إطار عرض الخريطة.
- عكس الترميز الجغرافي: يحوّل إحداثيات خطوط العرض والطول أو أرقام تعريف الأماكن إلى عناوين شوارع يمكن لشخص عادي قراءتها، وذلك للدبابيس التي يضعها المستخدم على الخريطة أو أدوات اختيار الموقع الجغرافي أو عرض واجهة المستخدم.
- الترميز الجغرافي للأماكن: يستردّ تفاصيل العناوين والإحداثيات لرقم تعريف مكان معروف على "خرائط Google".
يلخّص الجدول التالي الموارد المتاحة من خلال الإصدار 4 من Geocoding API، بالإضافة إلى البيانات التي تعرضها كل طريقة:
| مصادر البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
|---|---|---|
| البحث عن وجهات ( POST /v4/geocode/destinations)
|
تعرض هذه الميزة معلومات الوصول على مستوى منطقة محلية صغيرة: مضلّعات المباني والأراضي (displayPolygon)، وentrances المادية، وnavigationPoints القابلة للتوجيه (مع الرموز المميّزة)، وcontainingPlaces وsubDestinations الهرمية، وlandmarks العلائقية، وتفاصيل المكان الأساسية. يُرجى الاطّلاع على البحث عن الوجهات.
|
|
| الترميز الجغرافي لعنوان ( GET /v4/geocode/address)
|
تعرض هذه الدالة العنوان ومكوّناته وأنواعه. يُرجى الاطّلاع على استجابة الترميز الجغرافي. | |
| الترميز الجغرافي لموقع جغرافي ( GET /v4/geocode/location)
|
تعرض هذه الدالة العنوان ومكوّناته وأنواعه. يُرجى الاطّلاع على استجابة عكس الترميز الجغرافي. | |
| الترميز الجغرافي لمكان ( GET /v4/geocode/places)
|
تعرض هذه الدالة العنوان ومكوّناته وأنواعه. يُرجى الاطّلاع على استجابة الترميز الجغرافي للمكان. |
إطلاق قنوات Stage
يحتوي الإصدار 4 من Geocoding API على قنوات منفصلة للميزات المتاحة للجميع والميزات الحصرية والميزات التجريبية. إذا أردت استخدام ميزات "المعاينة" أو "التجريبية"،
احرص على تحديد القناة الصحيحة في طلبك. على سبيل المثال،
للوصول إلى ميزات نقطة نهاية "الوجهات" في الإصدار التجريبي، استخدِم طلب HTTP
التالي: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| مرحلة الإطلاق | اسم القناة |
|---|---|
| GA | /v4/ |
| نسخة حصرية | /v4beta/ |
| تجريبي | /v4alpha/ |
- يمكنك الاطّلاع على مرجع REST للحصول على قائمة بجميع موارد REST المتاحة ووصف لها.
- يمكنك الاطّلاع على مراحل الإطلاق لمزيد من المعلومات عن كل مرحلة.
الميزات في الإصدار 4 من Geocoding API
يوفّر الإصدار 4 من Geocoding API هذه الميزات الجديدة.
طريقة البحث عن الوجهة
يقدّم الإصدار الرابع طريقة بحث عن الوجهات تتيح لك استرداد معلومات تفصيلية عن وجهات مختلفة استنادًا إلى معايير إدخال مختلفة، مثل العنوان أو رقم تعريف المكان أو إحداثيات خطوط العرض والطول. يتضمّن الردّ ملخّصات مستندة إلى الذكاء الاصطناعي ورموز مميّزة لنقاط التنقّل تحتوي على معلومات سياقية يمكن تمريرها إلى حزمة تطوير البرامج (SDK) للتنقّل من أجل تحديد المسار بدقة.
تم تنفيذها على منصة Google Cloud العادية
يتم تنفيذ الإصدار 4 من Geocoding API على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية مع خيارات أمان محسّنة مثل OAuth. يوفّر تصميم واجهة برمجة التطبيقات العادي هذا مستوى من الاتساق في جميع واجهات برمجة التطبيقات، ما يحسّن كفاءة التطوير باستخدام الإصدار 4 من Geocoding API.
تمت إضافة دعم OAuth
يتيح الإصدار 4 من Geocoding API استخدام OAuth 2.0 للمصادقة. تتيح Google سيناريوهات OAuth 2.0 الشائعة، مثل تلك الخاصة بخادم الويب.
إضافة ميزة قناع الحقل
استخدِم أقنعة الحقول لتحديد المعلومات التي يجب أن يعرضها الردّ. بالنسبة إلى الطرق Geocode an address وGeocode a location وPlace geocoding، يتم تلقائيًا عرض جميع الحقول في عنصر الاستجابة. بالنسبة إلى طريقة البحث عن الوجهات، يجب تحديد قناع حقل في طلب البيانات من واجهة برمجة التطبيقات.
أمان واجهة برمجة التطبيقات
تم تصميم الإصدار 4 من Geocoding API كواجهة برمجة تطبيقات بين الخوادم. تؤدي الطلبات المباشرة من جهة العميل من المتصفّح إلى تعريض مفاتيح واجهة برمجة التطبيقات لخطر كبير يتمثل في السرقة وإساءة الاستخدام، لأنّ القيود المفروضة على مُحيل HTTP لا توفّر حماية كافية لنقاط نهاية خدمة الويب.
ننصحك بشدة باستدعاء Geocoding API v4 من خادمك الخلفي. لمزيد من التفاصيل حول أنماط التنفيذ الآمن والبدائل لاحتياجات من جهة العميل، يُرجى الاطّلاع على اعتبارات الأمان.