بعد الحصول على place_id من عملية بحث عن مكان، يمكنك طلب المزيد من التفاصيل حول مؤسسة معيّنة أو نقطة اهتمام معيّنة من خلال بدء طلب "تفاصيل المكان" (الإصدار القديم). يعرض طلب "تفاصيل المكان (الإصدار القديم)" معلومات أكثر شمولاً عن المكان المحدّد، مثل العنوان الكامل ورقم الهاتف وتقييمات المستخدمين ومراجعاتهم.
طلبات "تفاصيل المكان" (الإصدار القديم)
طلب "تفاصيل المكان (الإصدار القديم)" هو عنوان URL بتنسيق HTTP على النحو التالي:
https://maps.googleapis.com/maps/api/place/details/output?parameters
حيث يمكن أن تكون output إحدى القيمتين التاليتين:
json(موصى به) يشير إلى الإخراج بتنسيق JavaScript Object Notation (JSON)- تشير
xmlإلى أنّ الناتج بتنسيق XML
يجب توفّر مَعلمات معيّنة لبدء طلب بحث. وكما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف اللاتيني (&). في ما يلي قائمة بالمعلمات وقيمها المحتملة.
المعلمات المطلوبة
-
place_id
معرّف نصي يحدّد مكانًا بشكل فريد، ويتم عرضه من خلال البحث عن الأماكن. لمزيد من المعلومات حول معرّفات الأماكن، راجِع نظرة عامة على معرّفات الأماكن.
المعلمات الاختيارية
-
fields
تنبيه: لا تعرض طلبات البحث عن الأماكن وطلبات تفاصيل المكان الحقول نفسها. تعرض طلبات البحث عن الأماكن مجموعة فرعية من الحقول التي تعرضها طلبات تفاصيل المكان. إذا لم يعرض طلب البحث عن الأماكن الحقل الذي تريده، يمكنك استخدام طلب البحث عن الأماكن للحصول علىplace_id، ثم استخدام رقم تعريف المكان هذا لتقديم طلب تفاصيل المكان. لمزيد من المعلومات حول الحقول غير المتوفّرة في طلب البحث عن الأماكن، يُرجى الاطّلاع على الحقول المتوافقة مع Places API.استخدِم المَعلمة 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في الطلب، استخدِم اللغة المحدّدة كلغة مفضّلة للترجمة. في حال عدم إدخال قيمة، تحاول واجهة برمجة التطبيقات استخدام العنوانAccept-Languageكلغة مفضّلة.language -
reviews_sort
طريقة الترتيب التي سيتم استخدامها عند عرض المراجعات. يمكن ضبطها على
most_relevant(الإعداد التلقائي) أوnewest.-
بالنسبة إلى
most_relevant(الإعداد التلقائي)، يتم ترتيب المراجعات حسب مدى صلتها بموضوع البحث، وستعرض الخدمة النتائج التي كُتبت في الأصل باللغة المفضّلة. -
بالنسبة إلى
newest، يتم ترتيب المراجعات حسب التسلسل الزمني، ولا تؤثر اللغة المفضّلة في ترتيب المراجعات.
تنصح Google بعرض طريقة ترتيب المراجعات للمستخدم النهائي.
-
بالنسبة إلى
-
sessiontoken
سلسلة عشوائية تحدّد جلسة الإكمال التلقائي لأغراض الفوترة.
تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عندما يختار مكانًا ويتم إجراء طلب إلى "تفاصيل المكان". يمكن أن تتضمّن كل جلسة طلبات بحث متعددة، يليها اختيار مكان واحد. يجب أن تكون مفاتيح واجهة برمجة التطبيقات المستخدَمة في كل طلب ضمن الجلسة خاصة بالمشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يكون الرمز المميز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميزًا جديدًا لكل جلسة. في حال حذف المَعلمة
sessiontokenأو إعادة استخدام رمز مميّز للجلسة، سيتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (سيتم تحصيل رسوم كل طلب على حدة).ننصحك باتّباع الإرشادات التالية:
- استخدِم رموز الجلسات لجميع جلسات الإكمال التلقائي.
- إنشاء رمز مميز جديد لكل جلسة ننصح باستخدام الإصدار 4 من المعرّف الفريد العالمي (UUID).
- تأكَّد من أنّ مفاتيح واجهة برمجة التطبيقات المستخدَمة في جميع طلبات الإكمال التلقائي للأماكن وطلبات تفاصيل المكان ضمن الجلسة تنتمي إلى مشروع 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، في قاعدة بيانات "أماكن Google". -
INVALID_REQUESTللإشارة إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمت صياغته بشكل غير صحيح. -
OVER_QUERY_LIMITالتي تشير إلى أي مما يلي:- لقد تجاوزت الحدّ الأقصى لعدد الطلبات في الثانية.
- لم يتم تفعيل الفوترة في حسابك.
- تم تجاوز رصيد بقيمة 200 دولار أمريكي شهريًا أو الحد الأقصى للاستخدام الذي فرضته على نفسك.
- لم تعُد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة ائتمان).
-
REQUEST_DENIEDيشير إلى أنّه تم رفض طلبك، ويكون السبب عادةً أحد ما يلي:- لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
- المَعلمة
keyغير صالحة.
-
UNKNOWN_ERRORللإشارة إلى حدوث خطأ غير معروف.
مكان العمل
تمثّل هذه السمة سمات تصف مكانًا. لن تتوفّر بعض السمات لبعض أنواع الأماكن.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري |
Array<AddressComponent>
|
تمثّل هذه السمة مصفوفة تحتوي على المكوّنات المنفصلة التي تنطبق على هذا العنوان.
يمكنك الاطّلاع على |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان المكان بتنسيق adr microformat. |
|
اختياري | سلسلة |
تشير هذه السمة إلى حالة التشغيل الخاصة بالمكان، إذا كان نشاطًا تجاريًا.
في حال عدم توفّر بيانات، لن يتم عرض
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
اختياري | قيمة منطقية |
تحدِّد ما إذا كان النشاط التجاري يتيح خدمة استلام الطلبات من السيارة. |
|
اختياري | PlaceOpeningHours |
يحتوي هذا الحقل على ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمّن هذا الحقل الحقل الفرعي يمكنك الاطّلاع على PlaceOpeningHours للحصول على مزيد من المعلومات. |
|
اختياري | قيمة منطقية |
تحدِّد ما إذا كان النشاط التجاري يقدّم خدمة توصيل. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان النشاط التجاري يوفّر أماكن للجلوس في الداخل أو في الهواء الطلق. |
|
اختياري | PlaceEditorialSummary |
يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض النص الموجز كما هو، ولا يمكن تعديله أو تغييره. يمكنك الاطّلاع على PlaceEditorialSummary للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
سلسلة تحتوي على العنوان الذي يمكن لشخص عادي قراءته لهذا المكان وغالبًا ما يكون هذا العنوان مطابقًا للعنوان البريدي. يُرجى العِلم أنّ بعض البلدان، مثل المملكة المتحدة، لا تسمح بتوزيع العناوين البريدية الحقيقية بسبب قيود الترخيص. يتألف العنوان المنسّق منطقيًا من مكوّن واحد أو أكثر من مكوّنات العنوان. على سبيل المثال، يتألف العنوان "111 شارع 8، نيويورك، نيويورك" من المكوّنات التالية: "111" (رقم الشارع) و"شارع 8" (الطريق) و"نيويورك" (المدينة) و "نيويورك" (ولاية الولايات المتحدة). لا تحلّل العنوان المنسَّق آليًا. بدلاً من ذلك، عليك استخدام مكوّنات العنوان الفردية التي يتضمّنها ردّ من واجهة برمجة التطبيقات بالإضافة إلى حقل العنوان المنسّق. |
|
اختياري | سلسلة |
يحتوي على رقم الهاتف الخاص بالمكان بالتنسيق المحلي. |
|
اختياري | Geometry |
يحتوي على الموقع الجغرافي ونافذة العرض الخاصة به. يمكنك الاطّلاع على |
|
اختياري | سلسلة |
يحتوي على عنوان URL لرمز مقترَح يمكن عرضه للمستخدم عند الإشارة إلى هذه النتيجة على خريطة. |
|
اختياري | سلسلة |
تحتوي هذه السمة على رمز اللون السداسي العشري التلقائي لفئة المكان. |
|
اختياري | سلسلة |
يحتوي على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف |
|
اختياري | سلسلة |
يحتوي على رقم الهاتف الخاص بالمكان بالتنسيق الدولي.
يتضمّن التنسيق الدولي رمز البلد، ويسبقه علامة الجمع (+). على سبيل المثال، رقم الهاتف الدولي لمكتب Google في سيدني، أستراليا هو |
|
اختياري | سلسلة |
تحتوي على الاسم الذي يمكن للمستخدم قراءته للنتيجة التي تم إرجاعها. بالنسبة إلى نتائج |
|
اختياري | PlaceOpeningHours |
يحتوي على ساعات العمل العادية. اطّلِع على PlaceOpeningHours للحصول على مزيد من المعلومات. |
|
اختياري | قيمة منطقية |
استخدِم |
|
اختياري | Array<PlacePhoto> |
مصفوفة من عناصر الصور، يحتوي كل منها على مرجع إلى صورة قد يعرض الطلب ما يصل إلى عشر صور. يمكنك الاطّلاع على مزيد من المعلومات حول صور الأماكن وكيفية استخدام الصور في تطبيقك في مستندات صور الأماكن. يُرجى الاطّلاع على PlacePhoto للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
معرّف نصي يحدّد مكانًا بشكل فريد. لاسترداد معلومات حول المكان، مرِّر هذا المعرّف في الحقل |
|
اختياري | PlusCode |
مرجع موقع جغرافي مشفّر، مشتق من إحداثيات خطوط الطول والعرض، ويمثّل منطقة: 1/8000 من الدرجة في 1/8000 من الدرجة (حوالي 14 مترًا × 14 مترًا عند خط الاستواء) أو أصغر. يمكن استخدام Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). يمكنك الاطّلاع على 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" إلى المراجعة. |