حول Places API (جديدة)

تشمل واجهة Places API (الجديدة) واجهات برمجة التطبيقات التالية:

يحتوي هذا المستند على نظرة عامة على واجهات برمجة التطبيقات الجديدة هذه.

تفاصيل المكان (جديد)

يُعرِّف رقم تعريف المكان بشكلٍ فريد مكانًا في قاعدة بيانات أماكن Google وعلى خرائط Google. يمكنك طلب تفاصيل عن مكان محدّد باستخدام رقم تعريف المكان مؤسسة أو نقطة اهتمام من خلال بدء تفاصيل المكان (جديد) طلبك. يعرض طلب تفاصيل مكان (جديد) معلومات شاملة حول المكان المشار إليه مثل عنوانه الكامل ورقم هاتفه وتقييم المستخدم الزملاء.

هناك العديد من الطرق للحصول على رقم تعريف مكان. يمكنك استخدام:

صورة مكان (جديدة)

تتيح لك واجهة برمجة تطبيقات صور المكان (الجديدة) إضافة محتوى فوتوغرافي عالي الجودة إلى تطبيقك من خلال منحك إمكانية الدخول إلى ملايين الصور المخزنة في قاعدة بيانات أماكن Google. باستخدام واجهة برمجة تطبيقات "صور المكان" (الجديدة)، يمكنك الوصول إلى الصور وتغيير حجم الصورة إلى الحجم الأمثل لتطبيقك.

يجب أن تشتمل جميع الطلبات الموجّهة إلى واجهة برمجة تطبيقات "صور المكان" (الجديدة) على اسم مورد للصور. الذي يحدد الصورة المراد عرضها بشكل فريد. يمكنك الحصول على مرجع الصور الاسم باستخدام:

لتضمين اسم مورد الصور في الرد من تفاصيل المكان (جديد)، طلب بحث نصي (جديد) أو بحث قريب (جديد)، تأكد من تضمين الحقل photos في قناع حقل الطلب.

البحث النصي (جديد) والبحث عن قرب (جديد)

تتضمن واجهة Places API اثنين من واجهات برمجة التطبيقات للبحث:

  • البحث النصي (جديد)

    للسماح لك بتحديد سلسلة نصية للبحث عن مكان بشأنها. مثل: "الطعام النباتي الحار في سيدني، أستراليا" أو "مطعم للمأكولات البحرية الفاخرة بالقرب من بالو ألتو، كاليفورنيا".

    يمكنك تحسين عملية البحث من خلال تحديد تفاصيل، مثل مستويات الأسعار أو حالة الفتح الحالية أو التقييمات أو أنواع معيّنة من الأماكن. يمكنك أيضًا تحديد تحيز النتائج لموقع معين أو تقييد البحث إلى موقع محدد.

  • البحث عن الأجهزة المجاورة (جديد)

    للسماح لك بتحديد منطقة للبحث مع قائمة أنواع الأماكن. تحديد المنطقة كدائرة يحددها خط العرض وخط الطول إحداثيات النقطة المركزية ونصف القطر بالمتر.

    حدد نوعًا واحدًا أو أكثر من أنواع الأماكن التي تحدد خصائص الْمَكَانْ. على سبيل المثال، حدِّد "pizza_restaurant". و"shopping_mall" إلى البحث عن مطعم بيتزا موجود في مركز تسوق في .

ويكمن الاختلاف الرئيسي بين عمليتي البحث في أن البحث النصي (جديد) يتيح لك تحديد سلسلة بحث عشوائية في حين أن البحث عن قرب (جديد) يتطلب المنطقة التي تريد البحث فيها.

الإكمال التلقائي (جديد) والرموز المميزة للجلسة

الإكمال التلقائي (جديد) هي خدمة ويب تعرض عبارات بحث مقترحة تنبؤات طلب البحث استجابةً لطلب HTTP. حدِّد نصًا في الطلب. سلسلة البحث والحدود الجغرافية التي تتحكم في منطقة البحث

الرموز المميّزة للجلسة هي سلاسل من إنشاء المستخدمين تتتبّع طلبات الإكمال التلقائي (جديدة) بصفتها الجلسات. يستخدم الإكمال التلقائي (جديد) الرموز المميزة للجلسة لتجميع طلب البحث مراحل التحديد للبحث الذي يجريه المستخدم تلقائيًا للبحث في جلسة منفصلة الفوترة.

حقول وسمات وخيارات تسهيل الاستخدام الجديدة

Places API (الجديدة) تشمل حقولاً وسمات وخيارات لتسهيل الاستخدام جديدة لتزويد المستخدمين بمزيد من المعلومات حول مكان ما. هذه الجوانب الموضحة في الأقسام التالية.

الحقول

واجهة برمجة تطبيقات الأماكن (جديدة) تتضمن عدة حقول جديدة:

الحقل الوصف
regularSecondaryOpeningHours تصف هذه السمة أوقاتًا معينة لعمليات معينة. ثانوي تختلف ساعات العمل عن ساعات العمل الرئيسية للنشاط التجاري. بالنسبة على سبيل المثال، يمكن أن يحدد مطعم ساعات القيادة أو التوصيلات ساعات كساعات ثانوية.
paymentOptions خيارات الدفع التي يقبلها المكان يمكن أن يقبل المكان أكثر من خيار دفع واحد. إذا لم تكن بيانات خيار الدفع متوفرة، سيتم إلغاء تعيين حقل خيار الدفع. وتتضمّن الخيارات ما يلي:
  • بطاقة ائتمان
  • بطاقة السحب الآلي
  • الدفع النقدي فقط
  • الدفع من خلال الاتصال القصير المدى (NFC)
parkingOptions خيارات وقوف السيارات التي يقدمها المكان. وتتضمّن الخيارات ما يلي:
  • مواقف سيارات مجانية
  • مواقف سيارات مدفوعة
  • موقف سيارات مجاني في الشارع
  • خدمة ركن السيارات
  • موقف سيارات مجاني في مرآب
  • مرآب سيارات برسوم
subDestinations الأماكن الفريدة المرتبطة بمكان معيّن بالنسبة مثلاً، تُعتبر محطات المطار وجهات فرعية مطار.
fuelOptions أحدث المعلومات حول خيارات الوقود المتوفرة في محطة وقود جديدة. يتم تعديل هذه المعلومات بشكل منتظم. تشمل الخيارات ما يلي:
  • ديزل
  • عادي بدون توجيه
  • متوسط
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • غاز البترول المُسال
  • E80
  • E85
  • الميثان
  • ديزل حيوي
  • شاحنة ديزل
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 وتريد نقل تطبيقك إلى استخدام واجهات برمجة التطبيقات الجديدة، فراجع وثائق النقل التالية: