بعد الحصول على place_id من عملية بحث عن مكان، يمكنك طلب المزيد من التفاصيل حول مؤسسة معيّنة أو نقطة اهتمام معيّنة من خلال بدء طلب "تفاصيل المكان" (الإصدار القديم). يعرض طلب "تفاصيل المكان (الإصدار القديم)" معلومات أكثر شمولاً عن المكان المحدّد، مثل العنوان الكامل ورقم الهاتف وتقييمات المستخدمين ومراجعاتهم.
طلبات "تفاصيل المكان" (الإصدار القديم)
طلب "تفاصيل المكان (الإصدار القديم)" هو عنوان URL بتنسيق HTTP على النحو التالي:
https://maps.googleapis.com/maps/api/place/details/output?parameters
حيث يمكن أن تكون output إحدى القيمتين التاليتين:
- يشير
json(يُنصح به) إلى الإخراج بتنسيق كائن JavaScript Notation (JSON) - يشير
xmlإلى الناتج بتنسيق XML
يجب توفّر مَعلمات معيّنة لبدء طلب بحث. وكما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف (&). في ما يلي قائمة بالمعلمات وقيمها المحتملة.
المعلمات المطلوبة
-
place_id
معرّف نصي يحدّد مكانًا بشكل فريد، ويتم عرضه من خلال البحث عن الأماكن (الإصدار القديم). لمزيد من المعلومات حول معرّفات الأماكن، راجِع نظرة عامة على معرّفات الأماكن.
المعلمات الاختيارية
-
fields
تنبيه: لا تعرض طلبات البحث عن الأماكن (الإصدار القديم) وطلبات تفاصيل المكان (الإصدار القديم) الحقول نفسها. تعرض طلبات البحث عن الأماكن (الإصدار القديم) مجموعة فرعية من الحقول التي تعرضها طلبات تفاصيل المكان (الإصدار القديم). إذا لم يعرض البحث عن الأماكن (Legacy) الحقل الذي تريده، يمكنك استخدام البحث عن الأماكن (Legacy) للحصول علىplace_id، ثم استخدام رقم تعريف المكان هذا لإجراء طلب تفاصيل المكان (Legacy). لمزيد من المعلومات عن الحقول غير المتوفّرة في طلب البحث عن الأماكن (الإصدار القديم)، يُرجى الاطّلاع على حقول بيانات الأماكن (الإصدار القديم).استخدِم المَعلمة fields لتحديد قائمة قيم مفصولة بفاصلة لأنواع بيانات الأماكن المطلوب عرضها. على سبيل المثال:
fields=formatted_address,name,geometry. استخدِم شرطة مائلة للأمام عند تحديد قيم مركّبة. على سبيل المثال:opening_hours/open_now.تنقسم الحقول إلى ثلاث فئات للفوترة: أساسية جهة الاتصال الغلاف الجوي. يتم تحصيل رسوم عن وحدات SKU الأساسية ووحدات SKU الخاصة بجهات الاتصال ووحدات SKU الخاصة بالأجواء بالإضافة إلى وحدة SKU الأساسية (تفاصيل المكان أو العثور على مكان أو بحث في الجوار أو البحث النصي) للطلب الذي أدّى إلى ظهورها. لمزيد من المعلومات، اطّلِع على جدول الأسعار.
أساسي
تتضمّن فئة "أساسية" الحقول التالية:
address_componentsوadr_addressوbusiness_statusوformatted_addressوgeometryوiconوicon_mask_base_uriوicon_background_colorوnameوpermanently_closed(متوقّف نهائيًا) وphotoوplace_idوplus_codeوtypeوurlوutc_offsetوvicinityوwheelchair_accessible_entrance.التواصل
تتضمّن فئة "جهة الاتصال" الحقول التالية:
current_opening_hoursوformatted_phone_numberوinternational_phone_numberوopening_hoursوsecondary_opening_hoursوwebsiteالأجواء
تتضمّن فئة "الغلاف الجوي" الحقول التالية:
curbside_pickupوdeliveryوdine_inوeditorial_summaryوprice_levelوratingوreservableوreviewsوserves_beerوserves_breakfastوserves_brunchوserves_dinnerوserves_lunchوserves_vegetarian_foodوserves_wineوtakeoutوuser_ratings_total.ملاحظة: يتم دائمًا عرض بيانات المصدر،html_attributions، مع كل طلب، بغض النظر عمّا إذا كان قد تم طلب الحقل. -
language
اللغة التي سيتم عرض النتائج بها
- اطّلِع على قائمة اللغات المتاحة. تعدّل Google غالبًا اللغات المتوافقة، لذا قد لا تكون هذه القائمة شاملة.
-
في حال عدم توفير
language، تحاول واجهة برمجة التطبيقات استخدام اللغة المفضّلة كما هو محدّد في العنوانAccept-Language. - تبذل واجهة برمجة التطبيقات قصارى جهدها لتقديم عنوان شارع يمكن قراءته من قِبل المستخدمين والسكان المحليين. لتحقيق هذا الهدف، تعرض الخدمة عناوين الشوارع باللغة المحلية، مع ترجمتها إلى نص يمكن للمستخدم قراءته إذا لزم الأمر، مع مراعاة اللغة المفضّلة. يتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكونات العنوان باللغة نفسها، والتي يتم اختيارها من المكون الأول.
- إذا لم يتوفّر اسم باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات أقرب نتيجة مطابِقة.
- تؤثّر اللغة المفضّلة بشكل طفيف في مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، وفي ترتيب عرضها. يفسّر برنامج الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة ما ولكن ليس في لغة أخرى. على سبيل المثال، utca وtér هما كلمتان مترادفتان لكلمة "شارع" باللغة الهنغارية.
-
المنطقة
رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). معظم رموز نطاقات المستوى الأعلى لرمز البلد تتطابق مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، نطاق المستوى الأعلى لرمز البلد في المملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير تقنيًا إلى الكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
-
reviews_no_translations
حدِّد القيمة
reviews_no_translations=trueلإيقاف ترجمة المراجعات، أو حدِّد القيمةreviews_no_translations=falseلتفعيل ترجمة المراجعات. يتم عرض المراجعات بلغتها الأصلية.في حال عدم إدخال قيمة أو إدخال قيمة فارغة، يتم تفعيل ترجمة المراجعات. إذا تم تحديد المَعلمة
languageفي الطلب، استخدِم اللغة المحدّدة كلغة مفضّلة للترجمة. في حال عدم إدخال قيمةlanguage، تحاول واجهة برمجة التطبيقات استخدام عنوانAccept-Languageكلغة مفضّلة. -
reviews_sort
طريقة الترتيب التي سيتم استخدامها عند عرض المراجعات. يمكن ضبطها على
most_relevant(القيمة التلقائية) أوnewest.-
بالنسبة إلى
most_relevant(الإعداد التلقائي)، يتم ترتيب المراجعات حسب مدى صلتها بموضوع البحث، وستعطي الخدمة الأولوية للنتائج التي تتضمّن مراجعات مكتوبة باللغة المفضّلة. -
بالنسبة إلى
newest، يتم ترتيب المراجعات حسب التسلسل الزمني، ولا تؤثر اللغة المفضّلة في ترتيب الفرز.
تنصح Google بعرض طريقة ترتيب المراجعات للمستخدم النهائي.
-
بالنسبة إلى
-
sessiontoken
سلسلة عشوائية تحدّد جلسة الإكمال التلقائي لأغراض الفوترة.
تبدأ الجلسة عندما يبدأ المستخدم بكتابة طلب بحث، وتنتهي عندما يختار مكانًا ويتم إجراء طلب إلى تفاصيل المكان (قديم). يمكن أن تتضمّن كل جلسة طلبات بحث متعدّدة، يليها اختيار مكان واحد. يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة في كل طلب ضمن جلسة واحدة تابعة للمشروع نفسه على Google Cloud Console. وبعد انتهاء الجلسة، لن يكون الرمز المميّز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة. في حال حذف المَعلمة
sessiontokenأو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة).ننصحك باتّباع الإرشادات التالية:
- استخدِم رموز الجلسات المميزة لجميع جلسات الإكمال التلقائي.
- إنشاء رمز مميّز جديد لكل جلسة ننصح باستخدام معرّف فريد عالميًا من الإصدار 4.
- تأكَّد من أنّ مفاتيح واجهة برمجة التطبيقات المستخدَمة في جميع طلبات الإكمال التلقائي للمكان وطلبات تفاصيل المكان ضمن الجلسة تنتمي إلى مشروع Cloud Console نفسه.
- احرص على تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميز نفسه لأكثر من جلسة واحدة إلى احتساب تكلفة كل طلب على حدة.
مثال على "تفاصيل المكان" (الإصدار القديم)
يطلب المثال التالي تفاصيل مكان معيّن باستخدام place_id، ويتضمّن الحقول name وrating وformatted_phone_number:
محارة
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
يُرجى العِلم أنّه عليك استبدال المفتاح في هذا المثال بمفتاح واجهة برمجة التطبيقات الخاص بك لكي يعمل الطلب في تطبيقك.
ردّ تفاصيل المكان (الإصدار القديم)
يتم عرض الردود على طلبات بيانات "تفاصيل المكان" (الإصدار القديم) بالتنسيق المحدّد بواسطة العلامة output ضمن مسار عنوان URL للطلب.
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, { "height": 3036, "html_attributions": [ "Anna Linetsky", ], "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1", "width": 4048, }, { "height": 4016, "html_attributions": [ "Jonah Dell", ], "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD", "width": 6016, }, { "height": 3024, "html_attributions": [ "Anthony Huynh", ], "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jasen Baker", ], "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk", "width": 4032, }, { "height": 1515, "html_attributions": [ "Andrew W", ], "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI", "width": 2048, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39", "width": 4032, }, { "height": 4032, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas", "width": 3024, }, ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, { "author_name": "Jordy Baker", "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The staff is very friendly.", "time": 1641389490, }, { "author_name": "Prem Rathod", "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The location is convenient and easy to find.", "time": 1640159655, }, { "author_name": "Husuni Hamza", "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo", "rating": 5, "relative_time_description": "7 months ago", "text": "A modern and impressive facility.", "time": 1633197305, }, ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <review> <time>1641389490</time> <text>The staff is very friendly.</text> <author_name>Jordy Baker</author_name> <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1640159655</time> <text>The location is convenient and easy to find.</text> <author_name>Prem Rathod</author_name> <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1633197305</time> <text>A modern and impressive facility.</text> <author_name>Husuni Hamza</author_name> <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url> <rating>5.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>7 months ago</relative_time_description> </review> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
يحتوي كل من ردود JSON وXML على العناصر التالية:
PlacesDetailsResponse
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | Array<string> |
قد يحتوي على مجموعة من معلومات تحديد المصدر حول هذا الإدخال يجب عرضها للمستخدم (قد لا تتضمّن بعض الإدخالات معلومات تحديد المصدر). |
|
مطلوب | مكان |
تحتوي على معلومات مفصّلة حول المكان المطلوب. يمكنك الاطّلاع على مكان لمزيد من المعلومات. |
|
مطلوب | PlacesDetailsStatus |
يحتوي على حالة الطلب، وقد يتضمّن معلومات تصحيح الأخطاء لمساعدتك في معرفة سبب تعذُّر تلبية الطلب. يمكنك الاطّلاع على PlacesDetailsStatus لمزيد من المعلومات. |
|
اختياري | Array<string> |
عندما تعرض الخدمة معلومات إضافية حول مواصفات الطلب، قد يظهر حقل |
في استجابة JSON، يتم تمثيلها كعناصر جذرية. في استجابة XML، تظهر هذه العناصر كعناصر ذات مستوى أعلى ضمن <PlaceDetailsResponse>.
PlacesDetailsStatus
رموز الحالة التي تعرضها الخدمة
OKيشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمّ بنجاح.-
ZERO_RESULTSللإشارة إلى أنّ الموقع الجغرافي المشار إليه،place_id، كان صالحًا ولكنّه لم يعُد يشير إلى نتيجة صالحة. قد يحدث ذلك إذا لم يعُد المكان متاحًا. -
NOT_FOUND، ما يشير إلى أنّه لم يتم العثور على الموقع الجغرافي المشار إليه،place_id، في قاعدة بيانات "أماكن". -
INVALID_REQUESTللإشارة إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمت صياغته بشكل غير صحيح. -
OVER_QUERY_LIMITالتي تشير إلى أي مما يلي:- لقد تجاوزت الحد الأقصى لعدد الطلبات في الثانية.
- لم يتم تفعيل الفوترة في حسابك.
- تم تجاوز الرصيد الشهري البالغ 200 دولار أمريكي أو الحد الأقصى للاستخدام الذي فرضته على نفسك.
- طريقة الدفع المقدَّمة لم تعُد صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
-
REQUEST_DENIEDيشير إلى أنّه تم رفض طلبك، وعادةً ما يكون السبب أحد ما يلي:- لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
- المَعلمة
keyغير صالحة.
-
UNKNOWN_ERRORللإشارة إلى حدوث خطأ غير معروف.
المكان
تمثّل هذه السمة سمات تصف مكانًا. لن تتوفّر بعض السمات لبعض أنواع الأماكن.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري |
Array<AddressComponent>
|
تمثّل هذه السمة مصفوفة تحتوي على المكوّنات المنفصلة التي تنطبق على هذا العنوان.
يمكنك الاطّلاع على |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان المكان بتنسيق adr المصغّر. |
|
اختياري | سلسلة |
تشير هذه السمة إلى حالة التشغيل الخاصة بالمكان، إذا كان نشاطًا تجاريًا.
إذا لم تكن هناك أي بيانات، لن يتم عرض
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة الاستلام من السيارة. |
|
اختياري | PlaceOpeningHours |
تحتوي هذه السمة على ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمّن هذا الحقل الحقل الفرعي يمكنك الاطّلاع على PlaceOpeningHours لمزيد من المعلومات. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان النشاط التجاري يقدّم خدمة التوصيل. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان النشاط التجاري يوفّر خيارات للجلوس في أماكن داخلية أو خارجية. |
|
اختياري | PlaceEditorialSummary |
يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض النص الموجز كما هو، ولا يمكن تعديله أو تغييره. لمزيد من المعلومات، يُرجى الاطّلاع على PlaceEditorialSummary. |
|
اختياري | سلسلة |
سلسلة تحتوي على العنوان الذي يمكن لشخص عادي قراءته لهذا المكان وغالبًا ما يكون هذا العنوان مطابقًا للعنوان البريدي. يُرجى العِلم أنّ بعض البلدان، مثل المملكة المتحدة، لا تسمح بتوزيع العناوين البريدية الحقيقية بسبب القيود المفروضة على الترخيص. يتألف العنوان المنسّق منطقيًا من عنصر واحد أو أكثر من عناصر العنوان. على سبيل المثال، يتألف العنوان "111 شارع 8، نيويورك، نيويورك" من المكوّنات التالية: "111" (رقم الشارع)، و"شارع 8" (الطريق)، و"نيويورك" (المدينة)، و "نيويورك" (ولاية الولايات المتحدة). لا تحلّل العنوان المنسَّق آليًا. بدلاً من ذلك، عليك استخدام مكوّنات العنوان الفردية التي تتضمّنها استجابة واجهة برمجة التطبيقات بالإضافة إلى حقل العنوان المنسّق. |
|
اختياري | سلسلة |
يحتوي على رقم هاتف المكان بالتنسيق المحلي. |
|
اختياري | Geometry |
يحتوي على الموقع الجغرافي ونافذة العرض الخاصة به. يمكنك الاطّلاع على |
|
اختياري | سلسلة |
يحتوي على عنوان URL لرمز مقترَح يمكن عرضه للمستخدم عند الإشارة إلى هذه النتيجة على خريطة. |
|
اختياري | سلسلة |
تحتوي هذه السمة على رمز HEX التلقائي للون فئة المكان. |
|
اختياري | سلسلة |
تحتوي هذه السمة على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف |
|
اختياري | سلسلة |
يحتوي على رقم هاتف المكان بالتنسيق الدولي.
يتضمّن التنسيق الدولي رمز البلد، ويسبقه علامة الجمع (+). على سبيل المثال، رقم الهاتف الدولي لمكتب Google في سيدني، أستراليا هو |
|
اختياري | سلسلة |
تحتوي على الاسم الذي يمكن للمستخدم قراءته للنتيجة التي تم إرجاعها. بالنسبة إلى نتائج |
|
اختياري | PlaceOpeningHours |
يحتوي على ساعات العمل العادية. يمكنك الاطّلاع على PlaceOpeningHours لمزيد من المعلومات. |
|
اختياري | قيمة منطقية |
استخدِم |
|
اختياري | Array<PlacePhoto> |
مصفوفة من عناصر الصور، يحتوي كل منها على مرجع إلى صورة. قد يعرض الطلب ما يصل إلى عشر صور. يمكنك الاطّلاع على مزيد من المعلومات حول صور الأماكن وكيفية استخدام الصور في تطبيقك في مستندات صور الأماكن. يمكنك الاطّلاع على PlacePhoto لمزيد من المعلومات. |
|
اختياري | سلسلة |
معرّف نصي يحدّد مكانًا بشكل فريد. لاسترداد معلومات حول المكان، مرِّر هذا المعرّف في الحقل |
|
اختياري | PlusCode |
مرجع موقع جغرافي مشفّر، مشتق من إحداثيات خطوط الطول والعرض، ويمثّل منطقة: 1/8000 من الدرجة في 1/8000 من الدرجة (حوالي 14 مترًا × 14 مترًا عند خط الاستواء) أو أصغر. يمكن استخدام رموز Plus كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). اطّلِع على Open Location Code ورموز Plus Codes. يمكنك الاطّلاع على |
|
اختياري | الرقم |
مستوى سعر المكان، على مقياس من 0 إلى 4 سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى. يتم تفسير مستويات الأسعار على النحو التالي:
|
|
اختياري | الرقم |
تحتوي هذه السمة على تقييم المكان، من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين المجمَّعة. |
|
اختياري | سلسلة | تم إيقاف |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يتيح الحجز. |
|
اختياري | Array<PlaceReview> |
مصفوفة JSON تتضمّن ما يصل إلى خمس مراجعات يتم ترتيب المراجعات تلقائيًا حسب مدى صلتها بالموضوع. استخدِم مَعلمة الطلب
تنصح Google بأن توضّح للمستخدمين ما إذا كانت النتائج مرتّبة حسب يُرجى الاطّلاع على PlaceReview لمزيد من المعلومات. |
|
اختياري | سلسلة | تم إيقاف |
|
اختياري | Array<PlaceOpeningHours> |
تحتوي على مجموعة من الإدخالات للأيام السبعة التالية، بما في ذلك معلومات حول ساعات العمل الثانوية لنشاط تجاري. ساعات العمل الثانوية تختلف عن ساعات العمل الرئيسية للمؤسسة. على سبيل المثال، يمكن أن يحدّد مطعم ساعات عمل خدمة الطلب من السيارة أو ساعات عمل خدمة التوصيل كساعات عمل ثانوية. يملأ هذا الحقل الحقل الفرعي يمكنك الاطّلاع على PlaceOpeningHours لمزيد من المعلومات. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم البيرة. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان المكان يقدّم وجبة الإفطار. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان المكان يقدّم وجبات الإفطار المتأخر. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان المكان يقدّم العشاء. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم وجبات الغداء. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم طعامًا نباتيًا. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم النبيذ. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة استلام الطلبات. |
|
اختياري | Array<string> |
تحتوي على مصفوفة من أنواع الميزات التي تصف النتيجة المحدّدة. اطّلِع على قائمة الأنواع المتوافقة. |
|
اختياري | سلسلة |
يحتوي على عنوان URL الخاص بصفحة Google الرسمية لهذا المكان. ستكون هذه الصفحة من ملكية Google، وستتضمّن أفضل المعلومات المتوفّرة حول المكان. يجب أن تتضمّن التطبيقات رابطًا إلى هذه الصفحة أو أن تدمجها في أي شاشة تعرض للمستخدم نتائج تفصيلية حول المكان. |
|
اختياري | الرقم |
تمثّل هذه السمة إجمالي عدد المراجعات التي تتضمّن نصًا أو لا تتضمّنه لهذا المكان. |
|
اختياري | الرقم |
تحتوي هذه السمة على عدد الدقائق التي ينحرف بها التوقيت الحالي لهذا المكان عن التوقيت العالمي المتفق عليه. على سبيل المثال، بالنسبة إلى الأماكن في سيدني، أستراليا، خلال نظام التوقيت الصيفي، سيكون هذا الرقم 660 (+11 ساعة من التوقيت العالمي المتفق عليه)، وبالنسبة إلى الأماكن في كاليفورنيا خارج نظام التوقيت الصيفي، سيكون هذا الرقم -480 (-8 ساعات من التوقيت العالمي المتفق عليه). |
|
اختياري | سلسلة |
بالنسبة إلى نتائج
بالنسبة إلى جميع النتائج الأخرى، يحتوي الحقل يجب قراءة هذا المحتوى كما هو، ويُحظر تحليله آليًا. |
|
اختياري | سلسلة |
الموقع الإلكتروني الموثوق لهذا المكان، مثل الصفحة الرئيسية لنشاط تجاري |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يتضمّن مدخلاً مناسبًا لأصحاب الكراسي المتحرّكة. |
PlaceEditorialSummary
يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض النص الموجز كما هو، ولا يمكن تعديله أو تغييره.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | سلسلة |
لغة الحقول السابقة قد لا تكون هذه السمة متوفّرة دائمًا. |
|
اختياري | سلسلة |
تمثّل هذه السمة ملخّصًا نصيًا متوسط الطول عن المكان. |
PlaceOpeningHours
تمثّل هذه السمة عنصرًا يصف ساعات عمل مكان معيّن.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | قيمة منطقية |
قيمة منطقية تشير إلى ما إذا كان المكان مفتوحًا في الوقت الحالي. |
|
اختياري | Array<PlaceOpeningHoursPeriod> |
مصفوفة من فترات العمل تغطي سبعة أيام، بدءًا من يوم الأحد، بالترتيب الزمني. لمزيد من المعلومات، اطّلِع على PlaceOpeningHoursPeriod. |
|
اختياري | Array<PlaceSpecialDay> |
مصفوفة تتضمّن ما يصل إلى سبعة إدخالات تتوافق مع الأيام السبعة التالية. يمكنك الاطّلاع على PlaceSpecialDay لمزيد من المعلومات. |
|
اختياري | سلسلة |
سلسلة نوع تُستخدَم لتحديد نوع الساعات الثانوية (على سبيل المثال، |
|
اختياري | Array<string> |
تمثّل هذه السمة مصفوفة من السلاسل النصية التي تصف ساعات عمل المكان بنص يمكن لشخص عادي قراءته. |
PlaceOpeningHoursPeriod
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | PlaceOpeningHoursPeriodDetail |
تحتوي هذه السمة على زوج من عناصر اليوم والوقت التي تصف وقت فتح المكان. يمكنك الاطّلاع على PlaceOpeningHoursPeriodDetail للحصول على مزيد من المعلومات. |
|
اختياري | PlaceOpeningHoursPeriodDetail |
قد يحتوي على زوج من عناصر اليوم والوقت التي تصف وقت إغلاق المكان. إذا كان المكان مفتوحًا دائمًا، لن يظهر قسم الإغلاق في الرد. يمكن للعملاء الاعتماد على تمثيل حالة "مفتوح دائمًا" على أنّها فترة مفتوحة تتضمّن اليوم بالقيمة يمكنك الاطّلاع على PlaceOpeningHoursPeriodDetail للحصول على مزيد من المعلومات. |
PlaceSpecialDay
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | سلسلة |
تمثّل هذه السمة تاريخًا بالتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً 2010-12-31. |
|
اختياري | قيمة منطقية |
يتم عرض "صحيح" إذا كانت هناك ساعات عمل استثنائية لهذا اليوم. إذا كانت القيمة |
PlaceOpeningHoursPeriodDetail
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | الرقم |
رقم من 0 إلى 6، يتوافق مع أيام الأسبوع، بدءًا من يوم الأحد. على سبيل المثال، يشير الرقم 2 إلى يوم الثلاثاء. |
|
مطلوب | سلسلة |
قد يحتوي على وقت من اليوم بتنسيق hhmm على مدار 24 ساعة. تتراوح القيم بين 0000 و2359. سيتم عرض الوقت في المنطقة الزمنية للمكان. |
|
اختياري | سلسلة |
تمثّل هذه السمة تاريخًا بالتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً 2010-12-31. |
|
اختياري | قيمة منطقية |
تكون القيمة "صحيح" إذا تم اقتطاع فترة زمنية معيّنة بسبب حدّ أقصى يبلغ سبعة أيام، حيث تبدأ الفترة قبل منتصف الليل في تاريخ الطلب و/أو تنتهي عند منتصف الليل أو بعده في اليوم الأخير. تشير هذه السمة إلى أنّ فترة الفتح أو الإغلاق يمكن أن تمتد إلى ما بعد هذا الحدّ الأقصى البالغ سبعة أيام. |
PlacePhoto
صورة لمكان يمكن الوصول إلى الصورة باستخدام واجهة برمجة التطبيقات Place Photo من خلال عنوان URL بالتنسيق التالي:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
يمكنك الاطّلاع على مقالة صور الأماكن للحصول على مزيد من المعلومات.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | الرقم |
تمثّل هذه السمة ارتفاع الصورة. |
|
مطلوب | Array<string> |
سمات HTML الخاصة بالصورة |
|
مطلوب | سلسلة |
سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب Photo. |
|
مطلوب | الرقم |
عرض الصورة |
PlaceReview
مراجعة للمكان أرسلها أحد المستخدمين
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | سلسلة |
تمثّل هذه السمة اسم المستخدم الذي أرسل المراجعة. تتم إضافة المراجعات المجهولة المصدر إلى "مستخدم Google". |
|
مطلوب | الرقم |
تمثّل هذه السمة التقييم الإجمالي الذي قدّمه المستخدم لهذا المكان. هذا الرقم هو عدد صحيح يتراوح بين 1 و5. |
|
مطلوب | سلسلة |
تمثّل هذه السمة الوقت الذي تم فيه إرسال المراجعة كنص، وذلك بالنسبة إلى الوقت الحالي. |
|
مطلوب | الرقم |
تمثّل هذه السمة الوقت الذي تم فيه إرسال المراجعة، ويتم قياسه بعدد الثواني المنقضية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المنسق. |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان URL للملف الشخصي للمستخدم في برنامج "المرشدون المحليون" على "خرائط Google"، إذا كان متاحًا. |
|
اختياري | سلسلة |
تمثّل هذه السمة رمز لغة IETF يشير إلى لغة المراجعة المعروضة.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم تصنيف جميع المراجعات باللغة الإنجليزية على أنّها "en"، وليس "en-AU" أو "en-UK" وما إلى ذلك.يكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة. |
|
اختياري | سلسلة |
تمثّل هذه السمة رمز لغة IETF يشير إلى اللغة الأصلية للمراجعة. إذا تمت ترجمة المراجعة، ستكون قيمة |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان URL الخاص بصورة الملف الشخصي للمستخدم، إذا كان ذلك متاحًا. |
|
اختياري | سلسلة |
مراجعة المستخدم عند مراجعة موقع جغرافي باستخدام Google Places،
تُعتبر المراجعات النصية اختيارية. لذلك، قد يكون هذا الحقل فارغًا. يُرجى العِلم أنّ هذا الحقل قد يتضمّن ترميز HTML أساسيًا. على سبيل المثال، قد يمثّل مرجع الكيان |
|
اختياري | قيمة منطقية |
قيمة منطقية تشير إلى ما إذا تمت ترجمة المراجعة من اللغة الأصلية التي كُتبت بها.إذا تمت ترجمة المراجعة، أي إذا كانت القيمة صحيحة، تنصح Google بالإشارة إلى ذلك للمستخدمين. على سبيل المثال، يمكنك إضافة السلسلة التالية "مترجَمة بواسطة Google" إلى المراجعة. |