تشمل واجهة Places API (الجديدة) واجهات برمجة التطبيقات التالية:
- تفاصيل المكان (جديد)
- صورة المكان (جديدة)
- البحث عن الأجهزة المجاورة (جديد)
- البحث النصي (جديد)
- الإكمال التلقائي (جديد)
يحتوي هذا المستند على نظرة عامة على واجهات برمجة التطبيقات الجديدة هذه.
تفاصيل المكان (جديد)
يُعرِّف رقم تعريف المكان بشكلٍ فريد مكانًا في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". باستخدام رقم تعريف مكان، يمكنك طلب تفاصيل حول مؤسسة أو نقطة اهتمام معيّنة عن طريق بدء طلب تفاصيل المكان (جديد). يعرض طلب تفاصيل المكان (جديد) معلومات شاملة عن المكان المشار إليه مثل العنوان الكامل ورقم الهاتف وتقييم المستخدم والمراجعات.
هناك العديد من الطرق للحصول على رقم تعريف مكان. يمكنك استخدام:
- البحث النصي (جديد)
- البحث عن الأجهزة المجاورة (جديد)
- Geocoding API
- Routes API
- واجهة برمجة تطبيقات التحقق من صحة العنوان
- الإكمال التلقائي للأماكن
صورة مكان (جديدة)
تتيح لك واجهة برمجة تطبيقات Place Photo (New) API إضافة محتوى فوتوغرافي عالي الجودة إلى تطبيقك من خلال منحك إمكانية الوصول إلى ملايين الصور المخزنة في قاعدة بيانات أماكن Google. باستخدام واجهة برمجة تطبيقات صور الأماكن (الجديدة)، يمكنك الوصول إلى الصور وتغيير حجمها إلى الحجم الأمثل لتطبيقك.
يجب أن تشتمل جميع الطلبات الموجّهة إلى واجهة برمجة تطبيقات "صور المكان (الجديدة)" على اسم مورد للصور والذي يعرّف بشكل فريد الصورة المطلوب عرضها. يمكنك الحصول على اسم مورد الصور باستخدام:
لتضمين اسم مورد الصور في الرد من طلب "تفاصيل المكان" (جديد) أو "البحث النصي" (جديد) أو "بحث قريب" (جديد)، تأكد من تضمين الحقل photos
في قناع حقل الطلب.
البحث النصي (جديد) والبحث عن قرب (جديد)
تتضمن واجهة Places API اثنين من واجهات برمجة التطبيقات للبحث:
-
للسماح لك بتحديد سلسلة نصية للبحث عن مكان بشأنها. على سبيل المثال: "المأكولات النباتية الحارّة في سيدني، أستراليا" أو "مطعم المأكولات البحرية الفاخرة بالقرب من بالو ألتو، كاليفورنيا".
يمكنك تحسين عملية البحث من خلال تحديد تفاصيل مثل مستويات الأسعار أو حالة الافتتاح الحالية أو التقييمات أو أنواع معيّنة من الأماكن. ويمكنك أيضًا تحديد انحياز النتائج إلى موقع جغرافي معيّن، أو حصر البحث بموقع معيّن.
البحث عن الأجهزة المجاورة (جديد)
للسماح لك بتحديد منطقة للبحث مع قائمة أنواع الأماكن. حدد المنطقة كدائرة تحددها إحداثيي خط العرض وخط الطول لنقطة المركز ونصف القطر بالمتر.
حدِّد نوعًا واحدًا أو أكثر من أنواع الأماكن التي تحدِّد خصائص المكان. على سبيل المثال، حدِّد "
pizza_restaurant
" و "shopping_mall
" للبحث عن مطعم بيتزا يقع في مركز تسوّق في المنطقة المحددة.
الفرق الرئيسي بين عمليتي البحث هو أنّ البحث النصي (الجديد) يتيح لك تحديد سلسلة بحث عشوائية، في حين أن البحث عن قرب (جديد) يتطلب منطقة محددة للبحث فيها.
الإكمال التلقائي (جديد) والرموز المميزة للجلسة
الإكمال التلقائي (جديد) هي خدمة ويب تعرض عبارات بحث مقترحة وعبارات بحث استجابةً لطلب HTTP. في الطلب، حدِّد سلسلة بحث نصي والحدود الجغرافية التي تتحكّم في منطقة البحث.
الرموز المميزة للجلسة هي سلاسل من إنشاء المستخدمين تتتبّع استدعاءات الإكمال التلقائي (الجديدة) كجلسات. تستخدم ميزة الإكمال التلقائي (ميزة جديدة) رموز الجلسة المميّزة لتجميع مرحلتَي طلب البحث والاختيار من عملية بحث المستخدم للإكمال التلقائي في جلسة منفصلة لأغراض الفوترة.
حقول وسمات وخيارات تسهيل الاستخدام الجديدة
تتضمن Places API (الجديدة) حقولاً وسمات جديدة وخيارات تسهيل الاستخدام لتزويد المستخدمين بمزيد من المعلومات عن المكان. تم وصف هذه الجوانب في الأقسام التالية.
الحقول
واجهة برمجة تطبيقات الأماكن (جديدة) تتضمن عدة حقول جديدة:
الحقل | الوصف |
---|---|
regularSecondaryOpeningHours |
يشير إلى أوقات معيّنة لعمليات معيّنة. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدّد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات العمل الثانوية. |
paymentOptions |
خيارات الدفع التي يقبلها المكان ويمكن أن يقبل مكان ما أكثر من
خيار دفع واحد. إذا لم تتوفّر بيانات خيار الدفع، سيتم
إلغاء ضبط حقل خيار الدفع. وتشمل الخيارات ما يلي:
|
parkingOptions |
خيارات وقوف السيارات التي يقدمها المكان. وتشمل الخيارات ما يلي:
|
subDestinations |
الأماكن الفريدة المرتبطة بمكان معيّن على سبيل المثال، تُعتبر محطات المطارات وجهات فرعية للمطار. |
fuelOptions |
هي أحدث المعلومات حول خيارات الوقود المتوفّرة في
محطات وقود. يتم تعديل هذه المعلومات بشكل منتظم. وتشمل الخيارات
ما يلي:
|
evChargeOptions |
عدد شواحن المركبات الكهربائية في هذه المحطة علمًا أنّ بعض شواحن المركبات الكهربائية تتضمّن وصلات متعددة، يمكن لكل شاحن شحن مركبة واحدة فقط في كل مرة. ونتيجةً لذلك، يعرض هذا الحقل عدد محطات شحن المركبات الكهربائية المتاحة في وقت محدّد. |
shortFormattedAddress |
تمثّل هذه السمة عنوانًا قصيرًا لمكان محدّد ويمكن لشخص عادي قراءته. |
primaryType |
النوع الأساسي للنتيجة المقدمة. على سبيل المثال، قد يتم تصنيف مكان على أنّه cafe أو airport . يمكن أن يحتوي المكان على نوع أساسي واحد فقط. للحصول على القائمة الكاملة بالقيم المحتملة، راجِع الأنواع المسموح بها. |
primaryTypeDisplayName |
تمثّل هذه السمة الاسم المعروض للنوع الأساسي، بما يتناسب مع لغة الطلب، إذا كان ذلك منطبقًا. للحصول على القائمة الكاملة بالقيم المحتملة، راجِع الأنواع المتوافقة. |
السمات
تتضمن Places API (الجديدة) عدة سمات جديدة:
السمة | الوصف |
---|---|
outdoorSeating |
يوفّر المكان أماكن جلوس في الهواء الطلق. |
liveMusic |
ويقدم المكان عروضًا موسيقية حية. |
menuForChildren |
يضم المكان قائمة طعام للأطفال. |
servesCocktails |
يقدّم المكان مشروبات الكوكتيل. |
servesDessert |
يقدّم المكان الحلويات. |
servesCoffee |
يقدم المكان القهوة. |
goodForChildren |
المكان جيد للأطفال. |
allowsDogs |
يسمح الفندق باصطحاب الكلاب. |
restroom |
يضم المكان دورة مياه. |
goodForGroups |
يستوعب المكان مجموعات. |
goodForWatchingSports |
المكان مناسب لمشاهدة الألعاب الرياضية. |
خيارات تسهيل الاستخدام
تشمل واجهة Places API (الجديدة) حقول خيارات تسهيل الاستخدام التالية:
الحقل | الوصف |
---|---|
wheelchairAccessibleParking |
يوفر المكان موقفًا للسيارات صالح للكراسي المتحركة. |
wheelchairAccessibleEntrance |
يضم المكان مدخلاً مناسبًا لأصحاب الكراسي المتحرّكة. |
wheelchairAccessibleRestroom |
يضم المكان دورة مياه صالحة للكراسي المتحركة. |
wheelchairAccessibleSeating |
يضم المكان أماكن جلوس صالحة للكراسي المتحركة. |
الانتقال إلى واجهات برمجة تطبيقات الأماكن الجديدة
إذا كنت عميلاً حاليًا في Places API وتريد نقل بيانات تطبيقك لاستخدام واجهات برمجة التطبيقات الجديدة، يمكنك الاطّلاع على مستندات نقل البيانات التالية: