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

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

يُرجى العِلم أنّ رموز المناطق المكوّنة من 3 أرقام غير متاحة حاليًا.
sessionToken

string

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

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

ننصحك باتّباع الإرشادات التالية:

  • استخدِم الرموز المميزة للجلسات لجميع طلبات الإكمال التلقائي للأماكن.
  • إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 4.
  • تأكَّد من أنّ بيانات الاعتماد المستخدَمة في جميع طلبات الإكمال التلقائي للأماكن وPlace Details وAddress Validation خلال جلسة واحدة تنتمي إلى مشروع Cloud Console نفسه.
  • احرص على تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميز نفسه لأكثر من جلسة واحدة إلى تحرير فاتورة لكل طلب على حدة.

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform