وقتی place_id را از جستجوی جاها دریافت کردید، میتوانید با شروع درخواست «جزئیات جا (قدیمی)»، جزئیات بیشتری درباره یک مؤسسه یا نقطه جالب خاص درخواست کنید. درخواست «جزئیات جا» (قدیمی) اطلاعات جامعتری درباره مکان مشخصشده برمیگرداند، مثل نشانی کامل، شماره تلفن، ردهبندی کاربر، و مرورها.
درخواستهای Place Details (Legacy)
درخواست «جزئیات جا» (قدیمی) یک نشانی وب HTTP بهشکل زیر است:
https://maps.googleapis.com/maps/api/place/details/output?parameters
که در آن output میتواند یکی از مقادیر زیر باشد:
json(توصیهشده) نشاندهنده خروجی در JavaScript Object Notation (JSON) استxmlنشاندهنده برونداد بهصورت XML است
پارامترهای خاصی برای شروع درخواست جستجو لازم است. همانطور که در نشانیهای وب استاندارد است، همه پارامترها بااستفاده از نویسه اَمپرسند (&) از هم جدا میشوند. بخشهای زیر پارامترها و
مقادیر احتمالی آنها را فهرست میکند.
پارامترهای الزامی
place_id
شناسه نوشتاری که مکانی را بهطور یکتا شناسایی میکند و از جستجوی جاها (قدیمی) برگردانده میشود. برای اطلاعات بیشتر درباره شناسههای مکان، نمای کلی شناسه مکان را ببینید.
پارامترهای اختیاری
فیلدها
place_id استفاده کنید، سپس از آن «شناسه جا» برای ایجاد درخواست «جزئیات جا (قدیمی)» استفاده کنید. برای اطلاعات بیشتر درباره فیلدهایی که در درخواست «جستجوی مکان (قدیمی)» دردسترس نیستند، فیلدهای داده مکان (قدیمی) را ببینید.
از پارامتر فیلدها برای مشخص کردن فهرست جداشده با کاما از انواع دادههای مکان برای برگرداندن استفاده کنید. برای مثال:
fields=formatted_address,name,geometry. هنگام مشخص کردن مقادیر مرکب، از خط مورب استفاده کنید. برای مثال:
opening_hours/open_now.
فیلدها به سه دسته صورتحساب تقسیم میشوند: پایه، تماس، و جو. شناسههای Basic، Contact، و Atmosphere علاوهبر شناسه پایه (جزئیات جا، پیدا کردن جا، جستجوی اطراف، یا جستجوی نوشتار) برای درخواستی که آنها را راهاندازی کرده است، هزینه دریافت میکنند. برای اطلاعات بیشتر، برگه قیمتگذاری را ببینید.
پایه
دسته «پایه» شامل فیلدهای زیر است:
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،
همیشه با هر تماس برگردانده میشوند، صرفنظر از اینکه فیلد درخواست شده باشد یا نه.
زبان
زبانی که نتایج به آن برگردانده میشود.
- فهرست زبانهای پشتیبانیشده را ببینید. Google اغلب زبانهای پشتیبانیشده را بهروز میکند، بنابراین این فهرست ممکن است جامع نباشد.
-
اگر
languageارائه نشده باشد، API تلاش میکند از زبان ترجیحی مشخصشده در سرصفحهAccept-Languageاستفاده کند. - این API تمام تلاش خود را میکند تا نشانی خیابانی ارائه دهد که هم برای کاربر و هم برای افراد محلی قابلخواندن باشد. برای دستیابی به این هدف، نشانیهای خیابان را به زبان محلی برمیگرداند و درصورت لزوم، با رعایت زبان ترجیحی، آنها را به نویسهای که برای کاربر خوانا باشد نویسهگردانی میکند. همه نشانیهای دیگر به زبان ترجیحی برگردانده میشوند. همه مؤلفههای نشانی به همان زبانی برگردانده میشوند که از مؤلفه اول انتخاب شده است.
- اگر نامی به زبان ترجیحی دردسترس نباشد، API از نزدیکترین مطابقت استفاده میکند.
- زبان ترجیحی تأثیر کمی بر مجموعه نتایجی دارد که میانای برنامهسازی کاربردی برای برگرداندن انتخاب میکند و ترتیبی که برگردانده میشوند. زمینکدیاب اختصارات را بسته به زبان بهطور متفاوتی تفسیر میکند، مانند اختصارات برای انواع خیابانها، یا مترادفهایی که ممکن است در یک زبان معتبر باشند اما در زبان دیگر معتبر نباشند. برای مثال، utca و tér در زبان مجاری مترادف خیابان هستند.
منطقه
کد منطقه، که بهعنوان یک مقدار دو نویسهای ccTLD («دامنه سطح بالا») مشخص شده است. اکثر کدهای 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
رشتهای تصادفی که جلسه تکمیل خودکار را برای اهداف صورتحساب شناسایی میکند.
جلسه زمانی شروع میشود که کاربر شروع به تایپ کردن پُرسمان میکند و زمانی بهپایان میرسد که
کاربر مکانی را انتخاب میکند و تماسی با Place Details (Legacy) برقرار میشود. هر جلسه میتواند
چند پُرسمان داشته باشد و پساز آن یک مکان انتخاب شود. کلید(های) میانای برنامهسازی کاربردی
استفادهشده برای هر درخواست در یک جلسه باید به همان پروژه Google
Cloud Console تعلق داشته باشد. پساز پایان جلسه، توکن دیگر معتبر نیست؛ برنامهتان باید برای هر جلسه توکن جدیدی تولید کند. اگر
پارامتر sessiontoken حذف شود، یا اگر از کد جلسه
مجدداً استفاده کنید، هزینه جلسه بهگونهای محاسبه میشود که گویی هیچ کد جلسهای ارائه نشده است
(هر درخواست بهطور جداگانه صورتحساب میشود).
رهنمودهای زیر را توصیه میکنیم:
- از کد جلسه برای همه جلسههای تکمیل خودکار استفاده کنید.
- برای هر جلسه، یک کد جدید تولید کنید. استفاده از 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 در مسیر نشانی وب درخواست مشخص شده است برگردانده میشود.
(قالب) 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, }, // ... ], "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, }, // ... ], "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> <!-- ... --> <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> <!-- ... --> <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که نشان میدهد درخواست API موفقیتآمیز بوده است.-
ZERO_RESULTSنشان میدهد که مکان ارجاعشده،place_id، معتبر بوده است اما دیگر به نتیجه معتبری ارجاع نمیدهد. این اتفاق ممکن است زمانی رخ دهد که مؤسسه دیگر فعال نباشد. -
NOT_FOUNDنشان میدهد که مکان ارجاعدادهشده،place_id، در پایگاه داده «مکانها» پیدا نشد. -
INVALID_REQUESTنشان میدهد که درخواست میانای برنامهسازی کاربردی بدشکل بوده است. -
OVER_QUERY_LIMITکه نشاندهنده هریک از موارد زیر باشد:- از حد مجاز «پرسوجو در ثانیه» فراتر رفتهاید.
- صدور صورتحساب در حسابتان فعال نشده است.
- از اعتبار ماهانه ۲۰۰ دلاری یا سقف استفاده خودتحمیلی فراتر رفتهاید.
- روش پرداخت ارائهشده دیگر معتبر نیست (برای مثال، کارت اعتباری منقضی شده است).
-
REQUEST_DENIEDکه نشان میدهد درخواستتان رد شده است، معمولاً بهدلیل:- درخواست فاقد کلید میانای برنامهسازی کاربردی است.
- پارامتر
keyنامعتبر است.
UNKNOWN_ERRORکه نشاندهنده خطای ناشناخته است.
جا
مشخصههایی که مکان را توصیف میکند. همه مشخصهها برای همه انواع مکان دردسترس نخواهد بود.
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
اختیاری |
Array<AddressComponent>
|
آرایهای حاوی مؤلفههای جداگانه قابلاعمال به این نشانی.
برای اطلاعات بیشتر، به |
|
اختیاری | رشته |
نمایشی از نشانی مکان در ریزقالب adr. |
|
اختیاری | رشته |
وضعیت عملیاتی مکان را نشان میدهد، اگر کسبوکار باشد.
اگر دادهای وجود نداشته باشد،
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
اختیاری | بولی |
مشخص میکند که آیا کسبوکار از تحویل گرفتن کالا در کنار پیادهرو پشتیبانی میکند یا نه. |
|
اختیاری | PlaceOpeningHours |
حاوی ساعت کاری برای هفت روز آینده (شامل امروز) است. این دوره زمانی از نیمهشب تاریخ درخواست شروع میشود و ساعت ۱۱:۵۹ شب شش روز بعد پایان مییابد. این فیلد شامل زیرفیلد برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید. |
|
اختیاری | بولی |
مشخص میکند که آیا کسبوکار از ارسال پشتیبانی میکند یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا کسبوکار از گزینههای جای نشستن در فضای سرپوشیده یا فضای باز پشتیبانی میکند یا نه. options. |
|
اختیاری | PlaceEditorialSummary |
حاوی خلاصهای از مکان است. خلاصه شامل یک نمای کلی متنی است و همچنین درصورت وجود، کد زبان این موارد را نیز دربرمیگیرد. نوشتار خلاصه باید همانطور که هست ارائه شود و نمیتوان آن را اصلاح یا تغییر داد. برای اطلاعات بیشتر، به PlaceEditorialSummary مراجعه کنید. |
|
اختیاری | رشته |
رشتهای که حاوی نشانی قابلخواندن برای انسان از این مکان است. اغلب این نشانی معادل نشانی پستی است. توجه داشته باشید که برخی کشورها، مانند پادشاهی متحد، بهدلیل محدودیتهای صدور پروانه اجازه توزیع نشانیهای پستی واقعی را نمیدهند. نشانی قالببندیشده بهطور منطقی از یک یا چند مؤلفه نشانی تشکیل شده است. برای مثال، نشانی «111 8th Avenue, New York, NY» از بخشهای زیر تشکیل شده است: «111» (شماره خیابان)، «8th Avenue» (مسیر)، «New York» (شهر)، و «NY» (ایالت آمریکا). نشانی قالببندیشده را بهصورت برنامهنویسی تجزیه نکنید. بهجای آن باید از مؤلفههای نشانی فردی استفاده کنید که پاسخ میانای برنامهسازی کاربردی علاوهبر فیلد نشانی قالببندیشده شامل آن است. |
|
اختیاری | رشته |
حاوی شماره تلفن مکان در قالب محلی آن است. |
|
اختیاری | Geometry |
شامل مکان و نمای مکان است. برای اطلاعات بیشتر، به |
|
اختیاری | رشته |
حاوی نشانی وب نماد پیشنهادی است که ممکن است هنگام نشان دادن این نتیجه روی نقشه به کاربر نمایش داده شود. |
|
اختیاری | رشته |
حاوی کد رنگ HEX پیشفرض برای دسته مکان است. |
|
اختیاری | رشته |
حاوی نشانی وب نماد توصیهشده، منهای
افزونه نوع فایل |
|
اختیاری | رشته |
حاوی شماره تلفن مکان در قالب بینالمللی است.
قالب بینالمللی شامل کد کشور است و پیشوند آن علامت بهعلاوه (+) است. برای مثال، international_phone_number برای
دفتر Google در سیدنی استرالیا |
|
اختیاری | رشته |
حاوی نام قابلخواندن برای انسان برای نتیجه برگرداندهشده است. برای
نتایج |
|
اختیاری | PlaceOpeningHours |
حاوی ساعت کاری معمول است. برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید. |
|
اختیاری | بولی |
از |
|
اختیاری | Array<PlacePhoto> |
آرایهای از اشیای عکس، که هرکدام حاوی ارجاعی به یک تصویر است. درخواست ممکن است تا ده عکس را برگرداند. اطلاعات بیشتر درباره عکسهای مکان و نحوه استفاده از تصاویر در برنامهتان را میتوانید در سند عکسهای مکان پیدا کنید. برای اطلاعات بیشتر، PlacePhoto را ببینید. |
|
اختیاری | رشته |
شناسه متنی که مکان را بهطور منحصربهفردی شناسایی میکند. برای بازیابی اطلاعات مربوط به مکان، این شناسه را در فیلد |
|
اختیاری | PlusCode |
مرجع مکان کدگذاریشده، برگرفته از مختصات عرض جغرافیایی و طول جغرافیایی، که منطقهای را نشان میدهد: ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه (حدود ۱۴ متر در ۱۴ متر در خط استوا) یا کوچکتر. کدهای Plus را میتوان بهعنوان جایگزینی برای نشانی خیابان در مکانهایی که نشانی خیابان وجود ندارد (جایی که ساختمانها شمارهگذاری نشدهاند یا خیابانها نامگذاری نشدهاند) استفاده کرد. کد مکان باز و کدهای باز را ببینید. برای اطلاعات بیشتر، به |
|
اختیاری | شماره |
سطح قیمت مکان، در مقیاس ۰ تا ۴. مقدار دقیق نشاندادهشده با یک مقدار خاص از منطقهای به منطقه دیگر متفاوت خواهد بود. سطوح قیمت بهصورت زیر تفسیر میشود:
|
|
اختیاری | شماره |
حاوی ردهبندی مکان، از ۱٫۰ تا ۵٫۰، براساس مرورهای انبوهیده کاربر است. |
|
اختیاری | رشته | |
|
اختیاری | بولی |
مشخص میکند که آیا مکان از رزرو پشتیبانی میکند یا نه. |
|
اختیاری | Array<PlaceReview> |
آرایه JSON با حداکثر پنج مرور. بهطور پیشفرض، مرورها براساس میزان مربوط بودن مرتب میشوند. از پارامتر درخواست
Google توصیه میکند به کاربران نشان دهید که نتایج براساس برای اطلاعات بیشتر، PlaceReview را ببینید. |
|
اختیاری | رشته | |
|
اختیاری | Array<PlaceOpeningHours> |
حاوی آرایهای از ورودیها برای هفت روز آینده است، ازجمله
اطلاعاتی درباره ساعت کاری فرعی کسبوکار. ساعت کاری فرعی با ساعت کاری اصلی کسبوکار متفاوت است. برای نمونه، رستوران میتواند ساعتهای بگیر و بران یا ساعتهای ارسال را بهعنوان ساعتهای ثانویه خود مشخص کند. این فیلد زیرفیلد برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید. |
|
اختیاری | بولی |
مشخص میکند که آیا در این مکان آبجو سرو میشود یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا در این مکان صبحانه سرو میشود یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا در این مکان چاشت نیمروز سرو میشود یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا در این مکان شام سرو میشود یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا این مکان ناهار سرو میکند یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا این مکان غذای گیاهی سرو میکند یا نه. |
|
اختیاری | بولی |
مشخص میکند آیا در این مکان شراب سرو میشود یا نه. |
|
اختیاری | بولی |
مشخص میکند که آیا کسبوکار از غذای بیرونبر پشتیبانی میکند یا نه. |
|
اختیاری | Array<string> |
حاوی آرایهای از انواع ویژگی است که نتیجه ارائهشده را توصیف میکند. فهرست انواع پشتیبانیشده را ببینید. |
|
اختیاری | رشته |
حاوی نشانی وب صفحه رسمی Google برای این مکان است. این صفحه متعلق به Google خواهد بود که حاوی بهترین اطلاعات موجود درباره آن مکان است. برنامهها باید این صفحه را در هر صفحهای که نتایج دقیق درباره مکان را به کاربر نشان میدهد پیوند دهند یا جاسازی کنند. |
|
اختیاری | شماره |
تعداد کل مرورها، با یا بدون نوشتار، برای این مکان. |
|
اختیاری | شماره |
حاوی تعداد دقیقههایی است که منطقه زمانی فعلی این مکان از ساعت هماهنگ جهانی (UTC) انحراف دارد. برای مثال، برای مکانهایی در سیدنی، استرالیا درطول ساعت تابستانی، این مقدار ۶۶۰ (۱۱+ ساعت از ساعت هماهنگ جهانی) خواهد بود، و برای مکانهایی در کالیفرنیا خارج از ساعت تابستانی، این مقدار ۴۸۰- (۸- ساعت از ساعت هماهنگ جهانی) خواهد بود. |
|
اختیاری | رشته |
فقط برای نتایج مؤسسه (
برای همه نتایج دیگر، فیلد این محتوا باید همانطور که هست خوانده شود. نشانی قالببندیشده را بهصورت برنامهنویسیشده تجزیه نکنید. |
|
اختیاری | رشته |
وبسایت رسمی این مکان، مثلاً صفحه اصلی کسبوکار. |
|
اختیاری | بولی |
مشخص میکند که آیا مکان ورودیای دارد که برای صندلی چرخدار دسترسپذیر باشد. |
PlaceEditorialSummary
حاوی خلاصهای از مکان است. خلاصه شامل نمای کلی متنی است، و درصورت وجود، کد زبان این موارد را نیز دربرمیگیرد. نوشتار خلاصه باید همانطور که هست ارائه شود و نمیتوان آن را اصلاح یا تغییر داد.
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
اختیاری | رشته |
زبان فیلدهای قبلی. ممکن است همیشه وجود نداشته باشد. |
|
اختیاری | رشته |
خلاصه نوشتاری با طول متوسط از مکان. |
PlaceOpeningHours
شیئی که ساعات کاری مکان را توصیف میکند.
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
اختیاری | بولی |
مقدار بولی که نشان میدهد آیا مکان در زمان فعلی باز است یا نه. |
|
اختیاری | آرایه<PlaceOpeningHoursPeriod> |
آرایهای از دورههای باز بودن که هفت روز را پوشش میدهد و از یکشنبه بهترتیب زمانی شروع میشود. برای اطلاعات بیشتر، PlaceOpeningHoursPeriod را ببینید. |
|
اختیاری | Array<PlaceSpecialDay> |
آرایهای با حداکثر هفت ورودی مربوط به هفت روز آینده. برای اطلاعات بیشتر، PlaceSpecialDay را ببینید. |
|
اختیاری | رشته |
رشته نوعی که برای شناسایی نوع ساعت کاری فرعی استفاده میشود (برای مثال،
|
|
اختیاری | Array<string> |
آرایهای از رشتهها که ساعت کاری مکان را بهصورت نوشتار قابلخواندن برای انسان توصیف میکند. |
PlaceOpeningHoursPeriod
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
الزامی | PlaceOpeningHoursPeriodDetail |
حاوی یک جفت شیء روز و زمان است که زمان باز شدن مکان را توصیف میکند. برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید. |
|
اختیاری | PlaceOpeningHoursPeriodDetail |
ممکن است حاوی یک جفت شیء روز و زمان باشد که زمان بسته شدن مکان را
توصیف میکند. اگر مکانی همیشه باز باشد، بخش بسته شدن در پاسخ وجود نخواهد داشت. مشتریان میتوانند به نمایش همیشه باز بودن
بهصورت دوره باز حاوی روز با مقدار برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید. |
PlaceSpecialDay
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
اختیاری | رشته |
تاریخی که در قالب RFC3339 در منطقه زمانی محلی برای مکان بیان شده است، برای مثال 2010-12-31. |
|
اختیاری | بولی |
اگر ساعت کاری استثنایی برای این روز وجود داشته باشد، درست است. اگر
|
PlaceOpeningHoursPeriodDetail
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
الزامی | شماره |
عددی از ۰ تا ۶، مطابق با روزهای هفته، که از یکشنبه شروع میشود. برای مثال، ۲ یعنی سهشنبه. |
|
الزامی | رشته |
ممکن است حاوی زمان روز در قالب ۲۴ ساعته hhmm باشد. مقادیر در محدوده ۰۰۰۰ تا ۲۳۵۹ است. زمان براساس منطقه زمانی مکان گزارش خواهد شد. |
|
اختیاری | رشته |
تاریخی که در قالب RFC3339 در منطقه زمانی محلی برای مکان بیان شده است، برای مثال 2010-12-31. |
|
اختیاری | بولی |
اگر دوره معینی بهدلیل قطع هفت روزه کوتاه شده باشد، درست است، که در آن دوره قبلاز نیمهشب در تاریخ درخواست شروع میشود و/یا در نیمهشب یا بعداز آن در آخرین روز پایان مییابد. این ویژگی نشان میدهد که دوره باز یا بسته بودن میتواند از این محدودیت هفت روزه فراتر رود. |
PlacePhoto
عکس «مکان». بااستفاده از Place Photo API و نشانی وب با الگوی زیر میتوان به عکس دسترسی پیدا کرد:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
برای اطلاعات بیشتر، عکسهای مکان را ببینید.
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
الزامی | شماره |
ارتفاع عکس. |
|
الزامی | Array<string> |
ارجاعهای HTML برای عکس. |
|
الزامی | رشته |
رشتهای که برای شناسایی عکس هنگام درخواست «عکس» استفاده میشود. |
|
الزامی | شماره |
عرض عکس. |
PlaceReview
مروری از مکان که کاربری ارسال کرده است.
| فیلد | الزامی | نوع | شرح |
|---|---|---|---|
|
الزامی | رشته |
نام کاربری که مرور را ارسال کرده است. مرورهای ناشناس به «کاربر Google» نسبت داده میشود. |
|
الزامی | شماره |
ردهبندی کلی کاربر برای این مکان. این عدد کامل است، و از ۱ تا ۵ است. |
|
الزامی | رشته |
زمانی که مرور بهصورت نوشتاری ارسال شده است، نسبت به زمان فعلی. |
|
الزامی | شماره |
زمانی که مرور ارسال شده است، براساس تعداد ثانیههای سپریشده از نیمهشب ۱ ژانویه ۱۹۷۰ (ساعت هماهنگ جهانی). |
|
اختیاری | رشته |
نشانی وب نمایه «راهنمای محلی Google Maps» کاربر، درصورت وجود. |
|
اختیاری | رشته |
کد زبان IETF که زبان مرور برگرداندهشده را نشان میدهد.این فیلد فقط حاوی برچسب زبان اصلی است و برچسب ثانویه نشاندهنده کشور یا منطقه را ندارد. برای مثال، همه مرورهای انگلیسی با برچسب «en» مشخص میشوند و نه «en-AU» یا «en-UK» و غیره.اگر فقط ردهبندی وجود داشته باشد و نوشتار مروری وجود نداشته باشد، این فیلد خالی است. |
|
اختیاری | رشته |
کد زبان IETF که زبان اصلی مرور را نشان میدهد. اگر مرور ترجمه شده باشد،
|
|
اختیاری | رشته |
نشانی وب عکس نمایه کاربر، درصورت وجود. |
|
اختیاری | رشته |
مرور کاربر. هنگام مرور مکان با Google Places،
مرورهای نوشتاری اختیاری درنظر گرفته میشوند. بنابراین، این فیلد ممکن است
خالی باشد. توجه داشته باشید که این فیلد ممکن است شامل نشانهگذاری HTML پایه باشد. برای
مثال، مرجع نهاد |
|
اختیاری | بولی |
مقدار بولی که نشان میدهد آیا مرور از زبان اصلی که به آن نوشته شده ترجمه شده است یا نه.اگر مروری ترجمه شده باشد، مطابق با مقدار true، Google توصیه میکند که این موضوع را به کاربران خود نشان دهید. برای مثال، میتوانید رشته زیر را به مرور اضافه کنید: «ترجمهشده توسط Google». |