پیدا کردن جا (قدیمی)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

درخواست «یافتن مکان (قدیمی)» ورودی نوشتاری دریافت می‌کند و مکانی را برمی‌گرداند. ورودی می‌تواند هر نوع داده نوشتاری «مکان‌ها» باشد، مثل نام، نشانی، یا شماره تلفن. درخواست باید رشته باشد. درخواست «یافتن مکان (قدیمی)» بااستفاده از داده‌های غیررشته‌ای مثل مختصات طول/عرض جغرافیایی یا کد پلاس خطا ایجاد می‌کند.

درخواست‌های «پیدا کردن جا» (قدیمی)

درخواست «یافتن مکان» (قدیمی) نشانی وب HTTP به‌شکل زیر است:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

که در آن output می‌تواند یکی از مقادیر زیر باشد:

  • json (توصیه می‌شود) نشان‌دهنده برونداد در «نشان‌گذاری شیء جاوا اسکریپت» (JSON) است
  • xml نشان‌دهنده برونداد به‌عنوان XML است

پارامترهای خاصی برای شروع درخواست «یافتن مکان» (قدیمی) لازم است. همان‌طور که در نشانی‌های وب استاندارد است، همه پارامترها بااستفاده از نویسه امپرسند (&) از هم جدا می‌شوند.

پارامترهای الزامی

  • ورودی

    رشته نوشتاری که باید جستجو شود. باید نام مکان، نشانی، یا شماره تلفن باشد (برای مثال، «خیابان اصلی ۱۲۳» یا «شهرداری»).

  • inputtype

    نوع ورودی. این می‌تواند یکی از textquery یا phonenumber باشد. شماره تلفن‌ها باید در قالب بین‌المللی باشند (با علامت به‌علاوه («+») شروع شوند، سپس کد کشور، و بعد خود شماره تلفن). برای اطلاعات بیشتر، توصیه E.164 ITU را ببینید.

پارامترهای اختیاری

  • فیلدها

    احتیاط: درخواست‌های «جستجوی مکان» (قدیمی) و درخواست‌های «جزئیات مکان» (قدیمی) فیلدهای یکسانی برنمی‌گردانند. درخواست‌های «جستجوی مکان» (قدیمی) زیرمجموعه‌ای از فیلدهایی را برمی‌گرداند که درخواست‌های «جزئیات مکان» (قدیمی) برمی‌گرداند. اگر فیلد موردنظرتان توسط «جستجوی مکان» (قدیمی) برگردانده نمی‌شود، می‌توانید از «جستجوی مکان» (قدیمی) برای دریافت place_id استفاده کنید، سپس از آن «شناسه مکان» برای درخواست «جزئیات مکان» (قدیمی) استفاده کنید. برای اطلاعات بیشتر درباره فیلدهایی که در درخواست «جستجوی مکان» (قدیمی) دردسترس نیستند، به پشتیبانی فیلدهای Places API مراجعه کنید.

    از پارامتر فیلدها برای مشخص کردن فهرست جداشده با کاما از انواع داده‌های مکان برای برگرداندن استفاده کنید. برای مثال: fields=formatted_address,name,geometry. هنگام مشخص کردن مقادیر مرکب، از خط مورب استفاده کنید. برای مثال: opening_hours/open_now.

    فیلدها به سه دسته صورت‌حساب تقسیم می‌شوند: پایه، تماس، و جو. فیلدهای «پایه» با نرخ پایه صورت‌حساب می‌شوند و فیلدهای «تماس» و «جو» با نرخ بالاتری صورت‌حساب می‌شوند. «واحد نگهداری انبار» (SKU) «پایه»، «تماس»، و «جو» علاوه‌بر «واحد نگهداری انبار» پایه (Places Details،‏ Find Place،‏ Nearby Search، یا Text Search) برای درخواستی که آن‌ها را راه‌اندازی کرده است کسر هزینه می‌شود. برای اطلاعات بیشتر، برگه قیمت‌گذاری را ببینید.

    پایه

    دسته «پایه» شامل فیلدهای زیر است: 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 مترادف خیابان در زبان مجارستانی هستند.

  • locationbias

    با مشخص کردن شعاع به‌علاوه طول/عرض جغرافیایی، یا دو جفت طول/عرض جغرافیایی که نشان‌دهنده نقاط یک مستطیل است، نتایج را در یک منطقه مشخص ترجیح دهید. اگر این پارامتر مشخص نشده باشد، API به‌طور پیش‌فرض از گرایش نشانی IP استفاده می‌کند.

    • انحراف IP: به API دستور می‌دهد از انحراف نشانی IP استفاده کند. رشته ipbias را ارسال کنید (این گزینه پارامترهای اضافی ندارد).
    • دایره‌ای: رشته‌ای که شعاع را برحسب متر، به‌علاوه طول/عرض جغرافیایی را برحسب درجه اعشاری مشخص می‌کند. از قالب زیر استفاده کنید: circle:radius@lat,lng.
    • مستطیلی: رشته‌ای که دو جفت طول/عرض جغرافیایی را در درجه‌های اعشاری مشخص می‌کند، که نشان‌دهنده نقاط جنوب/غرب و شمال/شرق مستطیل است. از قالب زیر استفاده کنید:rectangle:south,west|north,east. توجه داشته باشید که مقادیر شرق/غرب به محدوده -۱۸۰، ۱۸۰ و مقادیر شمال/جنوب به محدوده -۹۰، ۹۰ محدود می‌شوند.

نمونه‌های «پیدا کردن جا» (قدیمی)

مثال زیر درخواست «یافتن مکان (قدیمی)» برای «موزه هنرهای معاصر استرالیا» را نشان می‌دهد، ازجمله فیلدهای photos، formatted_address، name، rating، opening_hours، و geometry:

فر کردن

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

مثال زیر درخواست «پیدا کردن مکان» (قدیمی) برای «گریل مغولی» را نشان می‌دهد که از پارامتر locationbias برای ترجیح دادن نتایج در فاصله ۲۰۰۰ متری مختصات مشخص‌شده استفاده می‌کند:

فر کردن

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

مثال زیر درخواست «یافتن مکان» (قدیمی) برای شماره تلفن را نشان می‌دهد. توجه داشته باشید که پیشوند تماس بین‌المللی «+» به‌صورت %2B کدگذاری شده است تا این درخواست نشانی وب سازگاری باشد. اگر کدبندی نشود، پیشوند + در سرور به فاصله کدبندی می‌شود و درنتیجه جستجوی شماره تلفن نامعتبر خواهد بود.

فر کردن

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

پاسخ‌های «پیدا کردن جا» (قدیمی)

پاسخ «یافتن مکان» (قدیمی) فقط حاوی انواع داده‌ای است که بااستفاده از پارامتر فیلدها مشخص شده‌اند، به‌علاوه html_attributions. مثال زیر پاسخ درخواست «یافتن مکان (قدیمی)» برای «موزه هنرهای معاصر استرالیا» را نشان می‌دهد، ازجمله فیلدهای formatted_address،‏ geometry،‏ name، opening_hours،‏ photos،‏ rating.

(قالب) JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

فیلد الزامی نوع شرح
الزامی Array<Place>

حاوی آرایه‌ای از نامزدهای «مکان» است.

درخواست‌های «جستجوی مکان» (قدیمی) زیرمجموعه‌ای از فیلدهایی را برمی‌گرداند که درخواست‌های «جزئیات مکان» (قدیمی) برمی‌گرداند. اگر فیلد موردنظرتان توسط «جستجوی مکان» (قدیمی) برگردانده نمی‌شود، می‌توانید از «جستجوی مکان» (قدیمی) برای دریافت place_id استفاده کنید، سپس از آن «شناسه مکان» برای درخواست «جزئیات مکان» (قدیمی) استفاده کنید.

برای اطلاعات بیشتر، مکان را ببینید.
الزامی PlacesSearchStatus

وضعیت درخواست را نشان می‌دهد و ممکن است حاوی اطلاعات اشکال‌زدایی باشد تا به شما کمک کند دلیل ناموفق بودن درخواست را پیدا کنید.

برای اطلاعات بیشتر، PlacesSearchStatus را ببینید.

اختیاری رشته

وقتی سرویس رمز وضعیتی غیراز OK< برمی‌گرداند، ممکن است فیلد error_message دیگری در شیء پاسخ وجود داشته باشد. این فیلد حاوی اطلاعات دقیق‌تری درباره دلایل رمز وضعیت ارائه‌شده است. این فیلد همیشه برگردانده نمی‌شود و محتوای آن ممکن است تغییر کند.

اختیاری Array<string>

وقتی سرویس اطلاعات بیشتری درباره مشخصات درخواست برمی‌گرداند، ممکن است فیلد info_messages دیگری در شیء پاسخ وجود داشته باشد. این فیلد فقط برای درخواست‌های موفق برگردانده می‌شود. ممکن است همیشه برگردانده نشود و محتوای آن مشمول تغییر است.

PlacesSearchStatus

رمزهای وضعیت برگردانده‌شده توسط سرویس.

  • OK نشان می‌دهد که درخواست API موفقیت‌آمیز بوده است.
  • ZERO_RESULTS نشان می‌دهد که جستجو موفقیت‌آمیز بوده است اما نتیجه‌ای برنگردانده است. این اتفاق ممکن است زمانی رخ دهد که جستجو به latlng در مکانی دور منتقل شده باشد.
  • ‫INVALID_REQUEST نشان می‌دهد درخواست میانای برنامه‌سازی کاربردی بدساخته شده است، معمولاً به‌دلیل ازقلم افتادن پارامتر پُرسمان الزامی (location یا radius).
  • OVER_QUERY_LIMIT نشان‌دهنده هریک از موارد زیر:
    • از حد مجاز «پرس‌وجو در ثانیه» فراتر رفته‌اید.
    • صدور صورت‌حساب در حسابتان فعال نشده است.
    • از اعتبار ماهانه ۲۰۰ دلار یا سقف استفاده خودتحمیلی فراتر رفته‌اید.
    • روش پرداخت ارائه‌شده دیگر معتبر نیست (برای مثال، کارت اعتباری منقضی شده است).
    برای اطلاعات بیشتر درباره نحوه برطرف کردن این خطا، پرسشگان Maps را ببینید.
  • REQUEST_DENIED که نشان می‌دهد درخواست شما رد شده است، معمولاً به این دلیل:
    • درخواست کلید میانای برنامه‌سازی کاربردی ندارد.
    • پارامتر key نامعتبر است.
  • ‫UNKNOWN_ERROR نشان‌دهنده خطای ناشناخته.

جا

مشخصه‌هایی که مکان را توصیف می‌کند. همه مشخصه‌ها برای همه انواع مکان دردسترس نیستند.

فیلد الزامی نوع شرح
اختیاری Array<AddressComponent>

آرایه‌ای حاوی مؤلفه‌های جداگانه قابل‌اعمال برای این نشانی.

برای اطلاعات بیشتر، به AddressComponent بروید.

اختیاری رشته

نمایشی از نشانی مکان در ریزفرمت adr.

اختیاری رشته

وضعیت فعالیت مکان را، درصورتی‌که کسب‌وکار باشد، نشان می‌دهد. اگر داده‌ای وجود نداشته باشد، business_status برگردانده نمی‌شود.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از تحویل گرفتن کالا در کنار جدول پشتیبانی می‌کند یا نه.
اختیاری PlaceOpeningHours

شامل ساعات کاری برای هفت روز آینده (ازجمله امروز) می‌شود. این دوره زمانی از نیمه‌شب تاریخ درخواست شروع می‌شود و در ساعت ۱۱:۵۹ شب شش روز بعد پایان می‌یابد. این فیلد شامل special_days زیرفیلد همه ساعات است که برای تاریخ‌هایی که ساعات کاری استثنایی دارند تنظیم شده است.

برای اطلاعات بیشتر، به PlaceOpeningHours مراجعه کنید.

اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از ارسال پشتیبانی می‌کند یا نه.
اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از گزینه‌های جای نشستن در فضای سرپوشیده یا روباز پشتیبانی می‌کند یا نه.

اختیاری PlaceEditorialSummary

حاوی خلاصه‌ای از مکان است. خلاصه شامل یک نمای کلی نوشتاری است و درصورت قابل‌اعمال بودن، کد زبان را نیز دربرمی‌گیرد. نوشتار خلاصه باید همان‌طور که هست ارائه شود و نمی‌توان آن را اصلاح یا تغییر داد.

برای اطلاعات بیشتر، PlaceEditorialSummary را ببینید.

اختیاری رشته

رشته‌ای که حاوی نشانی قابل‌خواندن برای انسان از این مکان است.

اغلب این نشانی معادل نشانی پستی است. توجه داشته باشید که برخی کشورها، مانند پادشاهی متحد (UK)، به‌دلیل محدودیت‌های صدور پروانه، اجازه توزیع نشانی‌های پستی واقعی را نمی‌دهند.

نشانی قالب‌بندی‌شده ازنظر منطقی از یک یا چند عنصر نشانی تشکیل شده است. برای مثال، نشانی «111 8th Avenue, New York, NY» از اجزای زیر تشکیل شده است: «111» (شماره خیابان)، «8th Avenue» (مسیر)، «New York» (شهر)، و «NY» (ایالت ایالات متحده).

نشانی قالب‌بندی‌شده را به‌صورت برنامه‌ریزی‌شده تجزیه نکنید. درعوض، باید از عناصر نشانی جداگانه استفاده کنید که پاسخ API علاوه‌بر فیلد نشانی قالب‌بندی‌شده، آن‌ها را نیز دربرمی‌گیرد.

اختیاری رشته

شماره تلفن مکان را در قالب محلی خود دارد.

اختیاری Geometry

مکان و درگاه دید مکان را دربرمی‌گیرد.

برای اطلاعات بیشتر، به Geometry بروید.
اختیاری رشته

حاوی نشانی وب نماد پیشنهادی است که ممکن است هنگام نشان دادن این نتیجه روی نقشه به کاربر نمایش داده شود.

اختیاری رشته

حاوی کد رنگ HEX پیش‌فرض برای دسته مکان است.
اختیاری رشته

حاوی نشانی وب نماد توصیه‌شده، منهای افزونه نوع فایل .svg یا .png است.

اختیاری رشته

شماره تلفن مکان را در قالب بین‌المللی دارد. قالب بین‌المللی شامل کد کشور است و پیشوند آن علامت به‌علاوه (+) است. برای مثال، international_phone_number برای دفتر Google در سیدنی استرالیا +61 2 9374 4000 است.

اختیاری رشته

شامل نام قابل‌خواندن برای انسان برای نتیجه برگشتی است. برای establishment نتیجه، این معمولاً نام کسب‌وکار متعارف است.

اختیاری PlaceOpeningHours

شامل ساعات کاری معمول است.

برای اطلاعات بیشتر، PlaceOpeningHours را ببینید.

اختیاری بولی

از business_status برای دریافت وضعیت عملیاتی کسب‌وکارها استفاده کنید.

اختیاری Array<PlacePhoto>

آرایه‌ای از اشیای عکس که هرکدام حاوی ارجاع به یک تصویر است. درخواست ممکن است حداکثر ده عکس برگرداند. اطلاعات بیشتر درباره عکس‌های مکان و نحوه استفاده از تصاویر در برنامه‌تان را می‌توانید در مستندات عکس‌های مکان پیدا کنید.

برای اطلاعات بیشتر، PlacePhoto را ببینید.
اختیاری رشته

شناسه نوشتاری که به‌طور منحصربه‌فرد مکانی را شناسایی می‌کند. برای بازیابی اطلاعات مربوط به مکان، این شناسه را در فیلد place_id درخواست Places API ارسال کنید. برای اطلاعات بیشتر درباره شناسه‌های مکان، نمای کلی شناسه مکان را ببینید.

اختیاری PlusCode

مرجع مکان کدگذاری‌شده، برگرفته از مختصات طول و عرض جغرافیایی، که منطقه‌ای را نشان می‌دهد: ۱/۸۰۰۰ درجه در ۱/۸۰۰۰ درجه (حدود ۱۴ متر در ۱۴ متر در خط استوا) یا کوچک‌تر. از کدهای باز می‌توان به‌عنوان جایگزین نشانی خیابان در مکان‌هایی که نشانی خیابان وجود ندارد (ساختمان‌ها شماره‌گذاری نشده‌اند یا خیابان‌ها نام‌گذاری نشده‌اند) استفاده کرد. کد مکان باز و کدهای باز را ببینید.

برای اطلاعات بیشتر، به PlusCode بروید.
اختیاری شماره

سطح قیمت مکان، در مقیاس ۰ تا ۴. مقدار دقیق نشان‌داده‌شده با یک مقدار خاص از منطقه‌ای به منطقه دیگر متفاوت خواهد بود. سطوح قیمت به‌صورت زیر تفسیر می‌شود:

  • ‫۰ رایگان
  • ‫۱ ارزان
  • ‫۲ متوسط
  • ‫۳ گران
  • ‫۴ بسیار گران
اختیاری شماره

حاوی رده‌بندی مکان، از ۱٫۰ تا ۵٫۰، براساس مرورهای انبوهیده کاربر است.

اختیاری رشته ‫
اختیاری بولی

مشخص می‌کند که مکان از رزرو پشتیبانی می‌کند یا نه.
اختیاری Array<PlaceReview>

آرایه JSON حداکثر پنج مرور. به‌طور پیش‌فرض، مرورها براساس ترتیب مربوط بودن مرتب می‌شوند. از پارامتر درخواست reviews_sort برای کنترل مرتب‌سازی استفاده کنید.

  • برای most_relevant (پیش‌فرض)، مرورها براساس ارتباط مرتب می‌شوند؛ سرویس نتایج را به‌گونه‌ای تنظیم می‌کند که مرورهای نوشته‌شده به زبان ترجیحی در اولویت قرار گیرند.
  • برای newest، مرورها به‌ترتیب زمانی مرتب می‌شوند؛ زبان ترجیحی بر ترتیب مرتب‌سازی تأثیر نمی‌گذارد.

Google توصیه می‌کند به کاربران نشان دهید که نتایج براساس most_relevant یا newest مرتب شده‌اند.

برای اطلاعات بیشتر، PlaceReview را ببینید.

اختیاری رشته ‫
اختیاری Array<PlaceOpeningHours>

شامل آرایه‌ای از ورودی‌ها برای هفت روز آینده است که اطلاعاتی درباره ساعات کاری فرعی کسب‌وکار را دربرمی‌گیرد. ساعت کاری فرعی با ساعت کاری اصلی کسب‌وکار متفاوت است. برای مثال، رستوران می‌تواند ساعات بگیر و بران یا ساعات ارسال را به‌عنوان ساعات ثانویه خود مشخص کند. این فیلد زیرفیلد type را پر می‌کند که از فهرست ازپیش تعریف‌شده‌ای از انواع ساعات کاری (مانند DRIVE_THROUGH، PICKUP، یا TAKEOUT) براساس انواع مکان استفاده می‌کند. این فیلد شامل special_days زیرفیلد همه ساعت‌ها است که برای تاریخ‌هایی که ساعت کاری استثنایی دارند تنظیم شده است.

برای اطلاعات بیشتر، PlaceOpeningHours را ببینید.

اختیاری بولی

مشخص می‌کند که آیا این مکان آبجو سرو می‌کند یا نه.
اختیاری بولی

مشخص می‌کند که آیا در این مکان صبحانه سرو می‌شود یا نه.
اختیاری بولی

مشخص می‌کند که آیا این مکان چاشت نیمروز سرو می‌کند یا نه.
اختیاری بولی

مشخص می‌کند که آیا در این مکان شام سرو می‌شود یا نه.
اختیاری بولی

مشخص می‌کند که آیا این مکان ناهار سرو می‌کند یا نه.
اختیاری بولی

مشخص می‌کند که آیا این مکان غذای گیاهی سرو می‌کند یا نه.
اختیاری بولی

مشخص می‌کند که آیا در این مکان شراب سرو می‌شود یا نه.
اختیاری بولی

مشخص می‌کند که آیا کسب‌وکار از تحویل در فروشگاه پشتیبانی می‌کند یا نه.
اختیاری Array<string>

شامل آرایه‌ای از انواع ویژگی‌هایی است که نتیجه داده‌شده را توصیف می‌کند. فهرست انواع پشتیبانی‌شده را ببینید.

اختیاری رشته

نشانی وب صفحه رسمی Google برای این مکان را دربردارد. این صفحه متعلق به Google خواهد بود که حاوی بهترین اطلاعات موجود درباره آن مکان است. برنامه‌ها باید در هر صفحه‌ای که نتایج دقیق درباره مکان را به کاربر نشان می‌دهد، به این صفحه پیوند دهند یا آن را جاسازی کنند.

اختیاری شماره

تعداد کل مرورها، با نوشتار یا بدون نوشتار، برای این مکان.

اختیاری شماره

شامل تعداد دقیقه‌هایی است که منطقه زمانی فعلی این مکان از «ساعت هماهنگ جهانی» انحراف دارد. برای مثال، برای مکان‌های سیدنی، استرالیا درطول ساعت تابستانی، این مقدار ۶۶۰ (+۱۱ ساعت از ساعت هماهنگ جهانی) خواهد بود، و برای مکان‌های کالیفرنیا خارج از ساعت تابستانی، این مقدار -۴۸۰ (-۸ ساعت از ساعت هماهنگ جهانی) خواهد بود.

اختیاری رشته

برای مؤسسه (types:["establishment", ...]) فقط نتایج)، فیلد vicinity حاوی نشانی ساده‌شده‌ای برای مکان است که شامل نام خیابان، شماره خیابان، و محله می‌شود، اما استان/ایالت، کد پستی، یا کشور را دربرنمی‌گیرد.

برای همه نتایج دیگر، فیلد vicinity حاوی نام باریک‌ترین ویژگی سیاسی (types:["political", ...]) است که در نشانی نتیجه وجود دارد.

این محتوا باید همان‌طور که هست خوانده شود. نشانی قالب‌بندی‌شده را به‌صورت برنامه‌نویسی‌شده تجزیه نکنید.

اختیاری رشته

وب‌سایت معتبر این مکان، مثلاً صفحه اصلی کسب‌وکار.

اختیاری بولی

مشخص می‌کند که آیا مکان ورودی‌ای دارد که برای صندلی چرخدار دسترس‌پذیر باشد.

PlaceEditorialSummary

حاوی خلاصه‌ای از مکان است. خلاصه شامل یک نمای کلی نوشتاری است، و درصورت وجود، کد زبان را نیز دربرمی‌گیرد. متن خلاصه باید همان‌گونه که هست ارائه شود و نمی‌تواند اصلاح یا تغییر داده شود.

فیلد الزامی نوع شرح
اختیاری رشته

زبان فیلدهای قبلی. ممکن است همیشه وجود نداشته باشد.
اختیاری رشته

خلاصه نوشتاری با طول متوسط از مکان.

PlaceOpeningHours

شیئی که ساعات کاری مکان را توصیف می‌کند.

فیلد الزامی نوع شرح
اختیاری بولی

مقدار بولی که نشان می‌دهد مکان در زمان فعلی باز است یا نه.

اختیاری Array<PlaceOpeningHoursPeriod>

آرایه‌ای از دوره‌های باز بودن که هفت روز را پوشش می‌دهد و از یکشنبه شروع می‌شود و به‌ترتیب زمانی است.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriod را ببینید.

اختیاری آرایه<PlaceSpecialDay>

آرایه‌ای از حداکثر هفت ورودی مربوط به هفت روز آینده.

برای اطلاعات بیشتر، PlaceSpecialDay را ببینید.

اختیاری رشته

رشته نوعی که برای شناسایی نوع ساعات کاری فرعی استفاده می‌شود (برای مثال، DRIVE_THROUGH، HAPPY_HOUR، DELIVERY، TAKEOUT، KITCHEN، BREAKFAST، LUNCH، DINNER، BRUNCH، PICKUP، SENIOR_HOURS). فقط برای secondary_opening_hours تنظیم می‌شود.

weekday_text

اختیاری Array<string>

آرایه‌ای از رشته‌ها که ساعات کاری مکان را با نوشتار قابل‌خواندن برای انسان توصیف می‌کند.

PlaceOpeningHoursPeriod

فیلد الزامی نوع شرح
الزامی PlaceOpeningHoursPeriodDetail

حاوی جفتی از اشیای روز و زمان است که زمان باز شدن مکان را شرح می‌دهد.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید.

اختیاری PlaceOpeningHoursPeriodDetail

ممکن است حاوی یک جفت شیء روز و زمان باشد که زمان بسته شدن مکان را توصیف می‌کند. اگر مکانی همیشه باز باشد، بخش بسته بودن در پاسخ وجود نخواهد داشت. مشتریان می‌توانند مطمئن باشند که همیشه باز بودن به‌صورت دوره باز حاوی روز با مقدار 0 و زمان با مقدار 0000 و بدون close نشان داده می‌شود.

برای اطلاعات بیشتر، PlaceOpeningHoursPeriodDetail را ببینید.

PlaceSpecialDay

فیلد الزامی نوع شرح
اختیاری رشته

تاریخی که در قالب RFC3339 در منطقه زمانی محلی برای مکان بیان شده است، برای مثال 2010-12-31.

اختیاری بولی

اگر برای این روز ساعت استثنایی وجود داشته باشد، درست است. اگر true، یعنی برای این روز حداقل یک استثنا وجود دارد. استثناها باعث می‌شوند مقادیر مختلفی در زیرفیلدهای current_opening_hours و secondary_opening_hours مانند periods، weekday_text، open_now رخ دهد. استثناها برای ساعت‌ها اعمال می‌شود و از ساعت‌ها برای تولید فیلدهای دیگر استفاده می‌شود.

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

برای اطلاعات بیشتر، عکس‌های مکان را ببینید.

فیلد الزامی نوع شرح
الزامی شماره

ارتفاع عکس.
الزامی آرایه<رشته>

ارجاع‌های HTML برای عکس.
الزامی رشته

رشته‌ای که برای شناسایی عکس هنگام انجام درخواست Photo استفاده می‌شود.

الزامی شماره

عرض عکس.

PlaceReview

مرور مکان که توسط کاربر ارسال شده است.

فیلد الزامی نوع شرح
الزامی رشته

نام کاربری که مرور را ارسال کرده است. مرورهای ناشناس به «کاربر Google» نسبت داده می‌شود.

الزامی شماره

رده‌بندی کلی کاربر برای این مکان. این عدد صحیح است و از ۱ تا ۵ متغیر است.

الزامی رشته

زمان ارسال مرور به‌صورت نوشتاری، نسبت به زمان فعلی.

الزامی شماره

زمان ارسال مرور، که برحسب تعداد ثانیه از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی (UTC) اندازه‌گیری می‌شود.

اختیاری رشته

نشانی وب نمایه «راهنمای محلی Google Maps» کاربر، درصورت دردسترس بودن.

اختیاری رشته

کد زبان IETF که نشان‌دهنده زبان مرور برگشتی است.این فیلد فقط حاوی برچسب زبان اصلی است و نه برچسب ثانویه که نشان‌دهنده کشور یا منطقه است. برای مثال، همه مرورهای انگلیسی با برچسب «en» نشان‌گذاری می‌شوند، نه «en-AU» یا «en-UK» و غیره.اگر فقط رده‌بندی بدون نوشتار مرور وجود داشته باشد، این فیلد خالی است.

اختیاری رشته

کد زبان IETF که زبان اصلی مرور را نشان می‌دهد. اگر مرور ترجمه شده باشد، original_language != language.این فیلد فقط حاوی برچسب زبان اصلی است و برچسب ثانویه نشان‌دهنده کشور یا منطقه را ندارد. برای مثال، همه مرورهای انگلیسی با برچسب «en» نشان‌گذاری می‌شوند، نه «en-AU» یا «en-UK» و غیره.اگر فقط رده‌بندی بدون نوشتار مرور وجود داشته باشد، این فیلد خالی است.

اختیاری رشته

نشانی وب عکس نمایه کاربر، درصورت دردسترس بودن.

text

اختیاری رشته

مرور کاربر. هنگام مرور مکان با «مکان‌های Google»، مرورهای نوشتاری اختیاری درنظر گرفته می‌شوند. بنابراین، این فیلد ممکن است خالی باشد. توجه داشته باشید که این فیلد ممکن است شامل نشانه‌گذاری HTML پایه باشد. برای مثال، مرجع نهاد &amp; ممکن است نشان‌دهنده نویسه اَمپرسند باشد.

اختیاری بولی

مقدار بولی که نشان می‌دهد آیا مرور از زبان اصلی که به آن نوشته شده ترجمه شده است یا نه.اگر مروری ترجمه شده باشد، مطابق با مقدار true، Google توصیه می‌کند که این موضوع را به کاربران خود نشان دهید. برای مثال، می‌توانید رشته زیر را به مرور اضافه کنید: «ترجمه‌شده توسط Google».