Method: places.get

يمكنك الحصول على تفاصيل المكان استنادًا إلى اسم مورده، وهو سلسلة بتنسيق places/{placeId}.

طلب HTTP

GET https://places.googleapis.com/v1/{name=places/*}

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
name

string

مطلوبة. تمثّل هذه السمة اسم المورد لمكان، بالتنسيق places/{placeId}.

معلمات طلب البحث

المَعلمات
languageCode

string

اختياريّ. سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت.

القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

اختياريّ. رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.
sessionToken

string

اختياريّ. سلسلة تحدِّد جلسة إكمال تلقائي لأغراض الفوترة. يجب أن تكون السلسلة آمنة من سلسلة base64 لعنوان URL ولها 36 حرف ASCII كحد أقصى. وفي حال عدم تنفيذ ذلك، يتم عرض خطأ POINTS_Quick.

تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عند اختيار مكان وإجراء مكالمة إلى "تفاصيل المكان" أو "التحقّق من صحة العنوان". ويمكن أن تحتوي كل جلسة على طلبات بحث متعددة، متبوعة بطلب واحد من أجل التحقّق من صحة تفاصيل المكان أو العنوان. يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب خلال جلسة إلى المشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يصبح الرمز المميز صالحًا، لذا يجب أن ينشئ تطبيقك رمزًا مميزًا جديدًا لكل جلسة. إذا تم حذف مَعلمة sessionToken، أو إذا أعدت استخدام رمز مميّز للجلسة، يتم تحصيل الرسوم من الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب على حدة).

نوصي بالإرشادات التالية:

  • استخدِم الرموز المميّزة للجلسة لجميع طلبات الإكمال التلقائي لـ "الأماكن".
  • إنشاء رمز مميّز جديد لكل جلسة ويُنصَح باستخدام الإصدار 4 من المعرّف الفريد العالمي (UUID).
  • تأكد من أن بيانات الاعتماد المستخدمة لجميع طلبات الإكمال التلقائي للأماكن وتفاصيل المكان وطلبات التحقق من صحة العنوان ضمن جلسة تنتمي إلى المشروع نفسه في Cloud Console.
  • تأكد من تمرير رمز مميز فريد للجلسة لكل جلسة جديدة. وسيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة إلى تحصيل رسوم كل طلب على حدة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Place.