Package google.maps.places.v1

Landmark

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

Area

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

string

نام منبع منطقه.

string

شناسه مکان منطقه.

LocalizedText

نام نمایشی منطقه.

Containment

رابطه مکانی بین مکان هدف و منطقه را تعریف می‌کند.

string

نام منبعِ آن مکان دیدنی.

string

شناسه مکانِ مورد نظر.

LocalizedText

نام نمایشی بنای تاریخی.

string

مجموعه‌ای از تگ‌های نوع برای این نشانه. برای فهرست کاملی از مقادیر ممکن، به https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

SpatialRelationship

رابطه مکانی بین مکان هدف و نقطه عطف را تعریف می‌کند.

float

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

float

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

string

نام نویسنده Photo یا Review .

string

آدرس اینترنتی (URI) نویسنده Photo یا Review .

string

آدرس اینترنتی عکس پروفایل نویسنده Photo یا Review .

string

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

LocationBias

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

حداکثر یکی از location_bias یا location_restriction باید تنظیم شود. اگر هیچ‌کدام تنظیم نشوند، نتایج توسط آدرس IP بایاس می‌شوند، به این معنی که آدرس IP به یک مکان نامشخص نگاشت شده و به عنوان یک سیگنال بایاس استفاده می‌شود.

LocationRestriction

اختیاری. نتایج را به یک مکان مشخص محدود کنید.

حداکثر یکی از location_bias یا location_restriction باید تنظیم شود. اگر هیچ‌کدام تنظیم نشوند، نتایج توسط آدرس IP بایاس می‌شوند، به این معنی که آدرس IP به یک مکان نامشخص نگاشت شده و به عنوان یک سیگنال بایاس استفاده می‌شود.

string

اختیاری. نوع مکان اصلی (مثلاً "رستوران" یا "پمپ بنزین") در انواع مکان ( https://developers.google.com/maps/documentation/places/web-service/place-types ) ، یا فقط (regions) ، یا فقط (cities) گنجانده شده است. یک مکان فقط در صورتی برگردانده می‌شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 5 مقدار را می‌توان مشخص کرد. اگر هیچ نوعی مشخص نشود، همه انواع مکان برگردانده می‌شوند.

string

اختیاری. فقط نتایج را در مناطق مشخص شده، که به عنوان حداکثر ۱۵ کد منطقه دو کاراکتری CLDR مشخص شده‌اند، لحاظ کنید. یک مجموعه خالی نتایج را محدود نمی‌کند. اگر هر دو location_restriction و included_region_codes تنظیم شوند، نتایج در ناحیه تقاطع قرار می‌گیرند.

string

اختیاری. زبانی که نتایج به آن برگردانده می‌شود. پیش‌فرض en-US است. اگر زبان مورد استفاده در input با language_code متفاوت باشد یا اگر Place برگردانده شده ترجمه‌ای از زبان محلی به language_code نداشته باشد، نتایج ممکن است به زبان‌های ترکیبی باشند.

string

اختیاری. کد منطقه، که به عنوان کد منطقه دو کاراکتری CLDR مشخص شده است. این بر قالب‌بندی آدرس، رتبه‌بندی نتایج تأثیر می‌گذارد و ممکن است بر نتایج بازگردانده شده تأثیر بگذارد. این امر نتایج را به منطقه مشخص شده محدود نمی‌کند. برای محدود کردن نتایج به یک منطقه، region_code_restriction استفاده کنید.

LatLng

اختیاری. نقطه مبدا که از آن فاصله ژئودزیک تا مقصد محاسبه می‌شود (به صورت distance_meters برگردانده می‌شود). اگر این مقدار حذف شود، فاصله ژئودزیک برگردانده نخواهد شد.

int32

اختیاری. یک آفست کاراکتر یونیکد مبتنی بر صفر از input که موقعیت مکان‌نما را در input نشان می‌دهد. موقعیت مکان‌نما ممکن است بر پیش‌بینی‌های برگردانده شده تأثیر بگذارد.

اگر خالی باشد، به طور پیش‌فرض طول input را در نظر می‌گیرد.

bool

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

string

اختیاری. رشته‌ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می‌کند. باید یک رشته base64 ایمن برای URL و نام فایل با حداکثر ۳۶ کاراکتر ASCII باشد. در غیر این صورت خطای INVALID_ARGUMENT بازگردانده می‌شود.

جلسه زمانی شروع می‌شود که کاربر شروع به تایپ یک پرس‌وجو می‌کند و زمانی که مکانی را انتخاب می‌کند و درخواست Place Details یا Address Validation انجام می‌شود، پایان می‌یابد. هر جلسه می‌تواند چندین پرس‌وجو داشته باشد و به دنبال آن یک درخواست Place Details یا Address Validation قرار گیرد. اعتبارنامه‌های استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان یک جلسه، توکن دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر session_token حذف شود، یا اگر از یک توکن جلسه دوباره استفاده کنید، هزینه جلسه طوری محاسبه می‌شود که انگار هیچ توکن جلسه‌ای ارائه نشده است (هزینه هر درخواست جداگانه محاسبه می‌شود).

ما دستورالعمل‌های زیر را توصیه می‌کنیم:

• از توکن‌های جلسه برای همه فراخوانی‌های تکمیل خودکار مکان استفاده کنید.
• برای هر جلسه یک توکن جدید ایجاد کنید. استفاده از UUID نسخه ۴ توصیه می‌شود.
• اطمینان حاصل کنید که اعتبارنامه‌های مورد استفاده برای همه درخواست‌های تکمیل خودکار مکان، جزئیات مکان و اعتبارسنجی آدرس در یک جلسه متعلق به یک پروژه Cloud Console هستند.
• حتماً برای هر جلسه جدید، یک توکن جلسه منحصر به فرد ارسال کنید. استفاده از یک توکن برای بیش از یک جلسه منجر به این می‌شود که برای هر درخواست، هزینه جداگانه محاسبه شود.

bool

اختیاری. اگر فیلد روی true تنظیم شده باشد، کسب‌وکارهای صرفاً خدماتی را نیز اضافه کنید. کسب‌وکار صرفاً خدماتی، کسب‌وکاری است که مستقیماً از مشتریان بازدید می‌کند یا به آنها کالا تحویل می‌دهد، اما به آدرس کسب‌وکار آنها خدمات ارائه نمی‌دهد. برای مثال، کسب‌وکارهایی مانند خدمات نظافت یا لوله‌کشی. این کسب‌وکارها آدرس فیزیکی یا مکانی در نقشه‌های گوگل ندارند. Places فیلدهایی از جمله location ، plus_code و سایر فیلدهای مرتبط با مکان را برای این کسب‌وکارها برنمی‌گرداند.

bool

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

Viewport

دریچه دیدی که توسط یک گوشه شمال شرقی و یک گوشه جنوب غربی تعریف شده است.

Circle

دایره‌ای که با یک نقطه مرکزی و شعاع مشخص می‌شود.

Viewport

دریچه دیدی که توسط یک گوشه شمال شرقی و یک گوشه جنوب غربی تعریف شده است.

Circle

دایره‌ای که با یک نقطه مرکزی و شعاع مشخص می‌شود.

Suggestion

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

PlacePrediction

پیشگویی برای یک مکان.

QueryPrediction

پیش‌بینی برای یک پرس‌وجو.

string

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

StringRange

فهرستی از محدوده‌های رشته‌ای که مشخص می‌کند درخواست ورودی در کجای text مطابقت دارد. این محدوده‌ها می‌توانند برای قالب‌بندی بخش‌های خاصی از text استفاده شوند. اگر تطبیق با معیارهایی غیر از تطبیق رشته (مثلاً تصحیح املا یا آوانویسی) تعیین شده باشد، ممکن است زیررشته‌ها دقیقاً با input مطابقت نداشته باشند.

این مقادیر، فاصله‌های کاراکتری text در یونیکد هستند. تضمین می‌شود که محدوده‌ها به ترتیب افزایشی مرتب شوند.

string

نام منبع مکان پیشنهادی. این نام می‌تواند در سایر APIهایی که نام مکان را می‌پذیرند، استفاده شود.

string

شناسه منحصر به فرد مکان پیشنهادی. این شناسه می‌تواند در سایر APIهایی که شناسه مکان را می‌پذیرند، استفاده شود.

FormattableText

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

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

این متن ممکن است با display_name برگردانده شده توسط GetPlace متفاوت باشد.

اگر input درخواست و language_code به زبان‌های مختلفی باشند یا اگر Place ترجمه‌ای از زبان محلی به language_code نداشته باشد، ممکن است به زبان‌های ترکیبی باشد.

StructuredFormat

تجزیه پیش‌بینی مکان به متن اصلی شامل نام مکان و متن ثانویه شامل ویژگی‌های ابهام‌زدایی اضافی (مانند شهر یا منطقه).

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

string

فهرست انواعی که برای این مکان از جدول A یا جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types اعمال می‌شوند.

یک نوع، دسته‌بندی یک مکان است. مکان‌هایی که انواع مشترکی دارند، ویژگی‌های مشابهی نیز خواهند داشت.

int32

طول ژئودزیک بر حسب متر از origin ، در صورتی که origin مشخص شده باشد. پیش‌بینی‌های خاصی مانند مسیرها ممکن است در این فیلد قرار نگیرند.

FormattableText

متن پیش‌بینی‌شده. این متن نشان‌دهنده‌ی یک مکان نیست، بلکه یک عبارت متنی است که می‌تواند در یک نقطه‌ی پایانی جستجو (مثلاً جستجوی متن) استفاده شود.

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

اگر input درخواست و language_code به زبان‌های مختلفی باشند یا اگر بخشی از پرس‌وجو ترجمه‌ای از زبان محلی به language_code نداشته باشد، ممکن است به زبان‌های ترکیبی باشد.

StructuredFormat

تجزیه پیش‌بینی پرس‌وجو به متن اصلی حاوی پرس‌وجو و متن ثانویه حاوی ویژگی‌های ابهام‌زدایی اضافی (مانند شهر یا منطقه).

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

int32

آفست مبتنی بر صفر اولین کاراکتر یونیکد رشته (شامل).

int32

آفست آخرین کاراکتر یونیکد مبتنی بر صفر (منحصراً).

FormattableText

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

FormattableText

ویژگی‌های ابهام‌زدایی اضافی (مانند یک شهر یا منطقه) را برای شناسایی بیشتر مکان یا اصلاح پرس‌وجو نشان می‌دهد.

LatLng

الزامی. طول و عرض جغرافیایی مرکز.

محدوده عرض جغرافیایی باید بین [-90.0، 90.0] و محدوده طول جغرافیایی باید بین [-180.0، 180.0] باشد.

double

الزامی. شعاع بر حسب متر اندازه‌گیری شده است. شعاع باید در محدوده [0.0، 50000.0] باشد.

LocalizedText

مطالب مرتبط با موضوع.

string

فهرست نام‌های منابع مکان‌های ارجاع‌شده. این نام می‌تواند در سایر APIهایی که نام‌های منابع Place را می‌پذیرند، استفاده شود.

Review

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

Photo

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

Justification

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

توجیهاتی برای مکان.

ReviewJustification

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

BusinessAvailabilityAttributesJustification

آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.

bool

اگر جایی غذای بیرون‌بر ارائه می‌دهد.

bool

اگر مکانی خدمات تحویل ارائه می‌دهد.

bool

اگر مکانی امکان صرف غذا در محل را فراهم می‌کند.

HighlightedText

Review

مروری که متن هایلایت شده از آن تولید شده است.

string

HighlightedTextRange

فهرست محدوده‌های متن هایلایت شده.

int32

int32

int32

تعداد کانکتورها در این ایستگاه. با این حال، از آنجا که برخی از پورت‌ها می‌توانند چندین کانکتور داشته باشند اما فقط می‌توانند یک خودرو را در یک زمان شارژ کنند (مثلاً)، تعداد کانکتورها ممکن است بیشتر از تعداد کل خودروهایی باشد که می‌توانند همزمان شارژ شوند.

ConnectorAggregation

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

EVConnectorType

نوع کانکتور این تجمیع.

double

حداکثر نرخ شارژ استاتیک بر حسب کیلووات برای هر کانکتور در تجمیع.

int32

تعداد کانکتورها در این تجمیع.

Timestamp

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

int32

تعداد کانکتورهای موجود در این مجموعه در حال حاضر.

int32

تعداد کانکتورهای موجود در این تجمیع که در حال حاضر از سرویس خارج هستند.

FuelPrice

آخرین قیمت سوخت شناخته شده برای هر نوع سوختی که این جایگاه دارد. برای هر نوع سوختی که این جایگاه دارد، یک ورودی وجود دارد. ترتیب مهم نیست.

FuelType

نوع سوخت.

Money

قیمت سوخت.

Timestamp

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

string

الزامی. نام منبع یک رسانه تصویری با فرمت: places/{place_id}/photos/{photo_reference}/media .

نام منبع یک عکس که در فیلد photos.name شیء Place برگردانده می‌شود، با فرمت places/{place_id}/photos/{photo_reference} می‌آید. برای دریافت نام منبع رسانه عکس، باید /media به انتهای منبع عکس اضافه کنید.

int32

اختیاری. حداکثر عرض دلخواه تصویر را بر حسب پیکسل مشخص می‌کند. اگر تصویر از مقادیر مشخص شده کوچکتر باشد، تصویر اصلی برگردانده می‌شود. اگر تصویر در هر دو بُعد بزرگتر باشد، مقیاس آن به گونه‌ای تنظیم می‌شود که با کوچکترین بُعد از دو بُعد مطابقت داشته باشد و به نسبت ابعاد اصلی خود محدود شود. هر دو ویژگی max_height_px و max_width_px یک عدد صحیح بین ۱ تا ۴۸۰۰ را می‌پذیرند. اگر مقدار در محدوده مجاز نباشد، خطای INVALID_ARGUMENT برگردانده می‌شود.

حداقل یکی از max_height_px یا max_width_px باید مشخص شود. اگر هیچ کدام از max_height_px یا max_width_px مشخص نشده باشند، خطای INVALID_ARGUMENT برگردانده می‌شود.

int32

اختیاری. حداکثر ارتفاع دلخواه تصویر را بر حسب پیکسل مشخص می‌کند. اگر تصویر از مقادیر مشخص شده کوچکتر باشد، تصویر اصلی برگردانده می‌شود. اگر تصویر در هر دو بُعد بزرگتر باشد، مقیاس آن به گونه‌ای تنظیم می‌شود که با کوچکترین بُعد از دو بُعد مطابقت داشته باشد و به نسبت ابعاد اصلی خود محدود شود. هر دو ویژگی max_height_px و max_width_px یک عدد صحیح بین ۱ تا ۴۸۰۰ را می‌پذیرند. اگر مقدار در محدوده مجاز نباشد، خطای INVALID_ARGUMENT برگردانده می‌شود.

حداقل یکی از max_height_px یا max_width_px باید مشخص شود. اگر هیچ کدام از max_height_px یا max_width_px مشخص نشده باشند، خطای INVALID_ARGUMENT برگردانده می‌شود.

bool

اختیاری. در صورت تنظیم، از رفتار پیش‌فرض تغییر مسیر HTTP صرف نظر کرده و پاسخی با فرمت متنی (مثلاً در قالب JSON برای مورد استفاده HTTP) ارائه می‌دهد. در صورت تنظیم نشدن، یک تغییر مسیر HTTP برای هدایت فراخوانی به رسانه تصویر صادر می‌شود. این گزینه برای درخواست‌های غیر HTTP نادیده گرفته می‌شود.

string

الزامی. نام منبع یک مکان، با فرمت places/{place_id} .

string

اختیاری. جزئیات مکان در صورت وجود با زبان دلخواه نمایش داده خواهد شد.

فهرست فعلی زبان‌های پشتیبانی‌شده: https://developers.google.com/maps/faq#languagesupport .

string

اختیاری. کد یونیکد کشور/منطقه (CLDR) مکانی که درخواست از آنجا می‌آید. این پارامتر برای نمایش جزئیات مکان، مانند نام مکان خاص منطقه، در صورت وجود، استفاده می‌شود. این پارامتر می‌تواند بر اساس قانون مربوطه بر نتایج تأثیر بگذارد. برای اطلاعات بیشتر، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید.

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

string

اختیاری. رشته‌ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می‌کند. باید یک رشته base64 ایمن برای URL و نام فایل با حداکثر ۳۶ کاراکتر ASCII باشد. در غیر این صورت خطای INVALID_ARGUMENT بازگردانده می‌شود.

جلسه زمانی شروع می‌شود که کاربر شروع به تایپ یک پرس‌وجو می‌کند و زمانی که مکانی را انتخاب می‌کند و درخواست Place Details یا Address Validation انجام می‌شود، پایان می‌یابد. هر جلسه می‌تواند چندین پرس‌وجو داشته باشد و به دنبال آن یک درخواست Place Details یا Address Validation قرار گیرد. اعتبارنامه‌های استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان یک جلسه، توکن دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر session_token حذف شود، یا اگر از یک توکن جلسه دوباره استفاده کنید، هزینه جلسه طوری محاسبه می‌شود که انگار هیچ توکن جلسه‌ای ارائه نشده است (هزینه هر درخواست جداگانه محاسبه می‌شود).

ما دستورالعمل‌های زیر را توصیه می‌کنیم:

• از توکن‌های جلسه برای همه فراخوانی‌های تکمیل خودکار مکان استفاده کنید.
• برای هر جلسه یک توکن جدید ایجاد کنید. استفاده از UUID نسخه ۴ توصیه می‌شود.
• اطمینان حاصل کنید که اعتبارنامه‌های مورد استفاده برای همه درخواست‌های تکمیل خودکار مکان، جزئیات مکان و اعتبارسنجی آدرس در یک جلسه متعلق به یک پروژه Cloud Console هستند.
• حتماً برای هر جلسه جدید، یک توکن جلسه منحصر به فرد ارسال کنید. استفاده از یک توکن برای بیش از یک جلسه منجر به این می‌شود که برای هر درخواست، هزینه جداگانه محاسبه شود.

string

شناسه. مرجعی که نشان‌دهنده عکس این مکان است و می‌توان از آن برای جستجوی مجدد عکس این مکان استفاده کرد (همچنین به آن نام "منبع" API نیز گفته می‌شود: places/{place_id}/photos/{photo} ).

int32

حداکثر عرض موجود، بر حسب پیکسل.

int32

حداکثر ارتفاع قابل دسترس، بر حسب پیکسل.

AuthorAttribution

نویسندگان این عکس.

string

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

string

لینکی برای نمایش عکس روی نقشه گوگل.

string

نام منبع یک رسانه تصویری با فرمت: places/{place_id}/photos/{photo_reference}/media .

string

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

string

نام منبع این مکان، با فرمت places/{place_id} . می‌توان از آن برای جستجوی مکان استفاده کرد.

string

شناسه منحصر به فرد یک مکان.

LocalizedText

نام محلی مکان، مناسب برای توضیح کوتاه و خوانا برای انسان. برای مثال، «گوگل سیدنی»، «استارباکس»، «پیرمونت» و غیره.

string

مجموعه‌ای از برچسب‌های نوع برای این نتیجه. به عنوان مثال، "political" و "locality". برای لیست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

string

نوع اصلی نتیجه داده شده. این نوع باید یکی از انواع پشتیبانی شده توسط Places API باشد. به عنوان مثال، "رستوران"، "کافه"، "فرودگاه" و غیره. یک مکان فقط می‌تواند یک نوع اصلی داشته باشد. برای لیست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید. اگر نوع اصلی مکان از نوع پشتیبانی شده نباشد، ممکن است نوع اصلی وجود نداشته باشد. وقتی یک نوع اصلی وجود دارد، همیشه یکی از انواع موجود در فیلد types است.

LocalizedText

نام نمایشی نوع اصلی، که در صورت لزوم به زبان درخواست بومی‌سازی شده است. برای لیست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید. اگر نوع اصلی مکان از نوع پشتیبانی شده نباشد، ممکن است نوع اصلی وجود نداشته باشد.

LocalizedText

برچسب نوع مکان در نقشه‌های گوگل، که در صورت لزوم به زبان درخواست بومی‌سازی شده است، برای مثال، "رستوران"، "کافه"، "فرودگاه" و غیره. برچسب نوع ممکن است با نام نمایشی نوع اصلی متفاوت باشد و ممکن است نوع پشتیبانی شده در جدول انواع مکان API Places نباشد.

string

یک شماره تلفن قابل خواندن توسط انسان برای آن مکان، در قالب ملی.

string

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

string

یک آدرس کامل و قابل خواندن توسط انسان برای این مکان.

string

یک آدرس کوتاه و خوانا برای این مکان.

PostalAddress

آدرس در قالب آدرس پستی.

AddressComponent

اجزای تکراری برای هر سطح محلی. به حقایق زیر در مورد آرایه address_components[] توجه کنید: - آرایه اجزای آدرس ممکن است شامل اجزای بیشتری نسبت به formatted_address باشد. - این آرایه لزوماً شامل تمام موجودیت‌های سیاسی که حاوی یک آدرس هستند، جدا از آنهایی که در formatted_address قرار دارند، نمی‌شود. برای بازیابی تمام موجودیت‌های سیاسی که حاوی یک آدرس خاص هستند، باید از geocoding معکوس استفاده کنید و طول/عرض جغرافیایی آدرس را به عنوان پارامتر به درخواست ارسال کنید. - تضمین نمی‌شود که قالب پاسخ بین درخواست‌ها یکسان باقی بماند. به طور خاص، تعداد address_components بر اساس آدرس درخواستی متفاوت است و می‌تواند در طول زمان برای همان آدرس تغییر کند. یک جزء می‌تواند موقعیت خود را در آرایه تغییر دهد. نوع جزء می‌تواند تغییر کند. یک جزء خاص ممکن است در پاسخ بعدی از دست رفته باشد.

PlusCode

کد بعلاوه موقعیت مکانی (طول/عرض).

LatLng

موقعیت این مکان.

Viewport

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

double

امتیازی بین ۱.۰ تا ۵.۰، بر اساس نظرات کاربران در مورد این مکان.

string

یک URL که اطلاعات بیشتری در مورد این مکان ارائه می‌دهد.

string

وب‌سایت معتبر برای این مکان، مثلاً صفحه اصلی یک کسب‌وکار. توجه داشته باشید که برای مکان‌هایی که بخشی از یک زنجیره هستند (مثلاً یک فروشگاه IKEA)، این معمولاً وب‌سایت فروشگاه مربوطه خواهد بود، نه کل زنجیره.

Review

فهرست نظرات درباره این مکان، مرتب شده بر اساس میزان اهمیت. حداکثر ۵ نظر قابل ارسال است.

OpeningHours

ساعات کاری معمول. توجه داشته باشید که اگر مکانی همیشه باز باشد (24 ساعت)، فیلد close تنظیم نمی‌شود. مشتریان می‌توانند به این نکته تکیه کنند که همیشه باز (24 ساعت) به صورت یک دوره open شامل day با مقدار 0 ، hour با مقدار 0 و minute با مقدار 0 نمایش داده می‌شود.

TimeZone

پایگاه داده منطقه زمانی IANA، منطقه زمانی. برای مثال "America/New_York".

Photo

اطلاعات (شامل منابع) در مورد عکس‌های این مکان. حداکثر ۱۰ عکس قابل بازگشت است.

string

آدرس مکان در ریزفرمت adr: http://microformats.org/wiki/adr .

BusinessStatus

وضعیت تجاری آن مکان.

Date

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

PriceLevel

سطح قیمت مکان.

Attribution

مجموعه‌ای از ارائه‌دهندگان داده که باید با این نتیجه نشان داده شوند.

string

یک URL کوتاه شده به یک ماسک آیکون. کاربر می‌تواند با اضافه کردن پسوند نوع به انتهای آن (مثلاً ".svg" یا ".png") به نوع آیکون‌های مختلف دسترسی پیدا کند.

string

رنگ پس‌زمینه برای icon_mask با فرمت هگز، مثلاً #909CE1.

OpeningHours

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

OpeningHours

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

OpeningHours

Contains an array of entries for information about regular secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place.

LocalizedText

Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.

PaymentOptions

Payment options the place accepts. If a payment option data is not available, the payment option field will be unset.

ParkingOptions

Options of parking provided by the place.

SubDestination

A list of sub-destinations related to the place.

FuelOptions

The most recent information about fuel options in a gas station. This information is updated regularly.

EVChargeOptions

Information of ev charging options.

GenerativeSummary

AI-generated summary of the place.

ContainingPlace

List of places in which the current place is located.

AddressDescriptor

The address descriptor of the place. Address descriptors include additional information that help describe a location using landmarks and areas. See address descriptor regional coverage in https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage .

GoogleMapsLinks

Links to trigger different Google Maps actions.

PriceRange

The price range associated with a Place.

ReviewSummary

AI-generated summary of the place using user reviews.

EvChargeAmenitySummary

The summary of amenities near the EV charging station.

NeighborhoodSummary

A summary of points of interest near the place.

ConsumerAlert

The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies.

string

If this Place is permanently closed and has moved to a new Place, this field contains the new Place's resource name, in places/{place_id} format. If this Place moved multiple times, this field will represent the first moved place. This field will not be populated if this Place has not moved.

string

If this Place is permanently closed and has moved to a new Place, this field contains the new Place's place ID. If this Place moved multiple times, this field will represent the first moved Place. This field will not be populated if this Place has not moved.

int32

Number of minutes this place's timezone is currently offset from UTC. This is expressed in minutes to support timezones that are offset by fractions of an hour, eg X hours and 15 minutes.

int32

The total number of reviews (with or without text) for this place.

bool

Specifies if the business supports takeout.

bool

Specifies if the business supports delivery.

bool

Specifies if the business supports indoor or outdoor seating options.

bool

Specifies if the business supports curbside pickup.

bool

Specifies if the place supports reservations.

bool

Specifies if the place serves breakfast.

bool

Specifies if the place serves lunch.

bool

Specifies if the place serves dinner.

bool

Specifies if the place serves beer.

bool

Specifies if the place serves wine.

bool

Specifies if the place serves brunch.

bool

Specifies if the place serves vegetarian food.

bool

Place provides outdoor seating.

bool

Place provides live music.

bool

Place has a children's menu.

bool

Place serves cocktails.

bool

Place serves dessert.

bool

Place serves coffee.

bool

Place is good for children.

bool

Place allows dogs.

bool

Place has restroom.

bool

Place accommodates groups.

bool

Place is suitable for watching sports.

AccessibilityOptions

Information about the accessibility options a place offers.

bool

Indicates whether the place is a pure service area business. Pure service area business is a business that visits or delivers to customers directly but does not serve customers at their business address. For example, businesses like cleaning services or plumbers. Those businesses may not have a physical address or location on Google Maps.

bool

Place offers wheelchair accessible parking.

bool

Places has wheelchair accessible entrance.

bool

Place has wheelchair accessible restroom.

bool

Place has wheelchair accessible seating.

string

The full text description or name of the address component. For example, an address component for the country Australia may have a long_name of "Australia".

string

An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short_name of "AU".

string

An array indicating the type(s) of the address component.

string

The language used to format this components, in CLDR notation.

string

Name of the Place's data provider.

string

URI to the Place's data provider.

string

The overview of the consumer alert message.

Details

The details of the consumer alert message.

string

The language code of the consumer alert message. This is a BCP 47 language code.

string

The title to show together with the description.

string

The description of the consumer alert message.

Link

The link to show together with the description to provide more information.

string

The title to show for the link.

string

The uri of the link.

string

The resource name of the place in which this place is located.

string

The place id of the place in which this place is located.

ContentBlock

An overview of the available amenities. This is guaranteed to be provided.

ContentBlock

A summary of the nearby coffee options.

ContentBlock

A summary of the nearby restaurants.

ContentBlock

A summary of the nearby stores.

string

A link where users can flag a problem with the summary.

LocalizedText

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

LocalizedText

The overview of the place.

string

A link where users can flag a problem with the overview summary.

LocalizedText

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

string

A link to show the directions to the place. The link only populates the destination location and uses the default travel mode DRIVE .

string

A link to show this place.

string

A link to write a review for this place on Google Maps.

string

A link to show reviews of this place on Google Maps.

string

A link to show photos of this place on Google Maps.

ContentBlock

An overview summary of the neighborhood.

ContentBlock

A detailed description of the neighborhood.

string

A link where users can flag a problem with the summary.

LocalizedText

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

Period

The periods that this place is open during the week. The periods are in chronological order, in the place-local timezone. An empty (but not absent) value indicates a place that is never open, eg because it is closed temporarily for renovations.

The starting day of periods is NOT fixed and should not be assumed to be Sunday. The API determines the start day based on a variety of factors. For example, for a 24/7 business, the first period may begin on the day of the request. For other businesses, it might be the first day of the week that they are open.

NOTE: The ordering of the periods array is independent of the ordering of the weekday_descriptions array. Do not assume they will begin on the same day.

string

Localized strings describing the opening hours of this place, one string for each day of the week.

NOTE: The order of the days and the start of the week is determined by the locale (language and region). The ordering of the periods array is independent of the ordering of the weekday_descriptions array. Do not assume they will begin on the same day.

Will be empty if the hours are unknown or could not be converted to localized text. Example: "Sun: 18:00–06:00"

SecondaryHoursType

A type string used to identify the type of secondary hours.

SpecialDay

Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, eg Christmas day. Set for current_opening_hours and current_secondary_opening_hours if there are exceptional hours.

Timestamp

The next time the current opening hours period starts up to 7 days in the future. This field is only populated if the opening hours period is not active at the time of serving the request.

Timestamp

The next time the current opening hours period ends up to 7 days in the future. This field is only populated if the opening hours period is active at the time of serving the request.

bool

Whether the opening hours period is currently active. For regular opening hours and current opening hours, this field means whether the place is open. For secondary opening hours and current secondary opening hours, this field means whether the secondary hours of this place is active.

Point

The time that the place starts to be open.

Point

The time that the place starts to be closed.

Date

Date in the local timezone for the place.

bool

Whether or not this endpoint was truncated. Truncation occurs when the real hours are outside the times we are willing to return hours between, so we truncate the hours back to these boundaries. This ensures that at most 24 * 7 hours from midnight of the day of the request are returned.

int32

A day of the week, as an integer in the range 0-6. 0 is Sunday, 1 is Monday, etc.

int32

The hour in 24 hour format. Ranges from 0 to 23.

int32

The minute. Ranges from 0 to 59.

Date

The date of this special day.

bool

Place offers free parking lots.

bool

Place offers paid parking lots.

bool

Place offers free street parking.

bool

Place offers paid street parking.

bool

Place offers valet parking.

bool

Place offers free garage parking.

bool

Place offers paid garage parking.

bool

Place accepts credit cards as payment.

bool

Place accepts debit cards as payment.

bool

Place accepts cash only as payment. Places with this attribute may still accept other payment methods.

bool

Place accepts NFC payments.

string

Place's global (full) code, such as "9FWM33GV+HQ", representing an 1/8000 by 1/8000 degree area (~14 by 14 meters).

string

Place's compound code, such as "33GV+HQ, Ramberg, Norway", containing the suffix of the global code and replacing the prefix with a formatted name of a reference entity.

LocalizedText

The summary of user reviews.

string

A link where users can flag a problem with the summary.

LocalizedText

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

string

A link to show reviews of this place on Google Maps.

string

The resource name of the sub-destination.

string

The place id of the sub-destination.

string

An encoded polyline , as returned by the Routes API by default . See the encoder and decoder tools.

Money

The low end of the price range (inclusive). Price should be at or above this amount.

Money

The high end of the price range (exclusive). Price should be lower than this amount.

string

A reference representing this place review which may be used to look up this place review again (also called the API "resource" name: places/{place_id}/reviews/{review} ).

string

A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.

LocalizedText

The localized text of the review.

LocalizedText

The review text in its original language.

double

A number between 1.0 and 5.0, also called the number of stars.

AuthorAttribution

This review's author.

Timestamp

Timestamp for the review.

string

A link where users can flag a problem with the review.

string

A link to show the review on Google Maps.

Date

The date when the author visited the place. This is truncated to the year and month of the visit.

bool

Optional. When set to true, avoids toll roads where reasonable, giving preference to routes not containing toll roads. Applies only to the DRIVE and TWO_WHEELER TravelMode .

bool

Optional. When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the DRIVE and TWO_WHEELER TravelMode .

bool

Optional. When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the DRIVE and TWO_WHEELER TravelMode .

bool

Optional. When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the WALK TravelMode .

LatLng

Optional. An explicit routing origin that overrides the origin defined in the polyline. By default, the polyline origin is used.

TravelMode

Optional. The travel mode.

RouteModifiers

Optional. The route modifiers.

RoutingPreference

Optional. Specifies how to compute the routing summaries. The server attempts to use the selected routing preference to compute the route. The traffic aware routing preference is only available for the DRIVE or TWO_WHEELER travelMode .

Leg

The legs of the trip.

When you calculate travel duration and distance from a set origin, legs contains a single leg containing the duration and distance from the origin to the destination. When you do a search along route, legs contains two legs: one from the origin to place, and one from the place to the destination.

string

A link to show directions on Google Maps using the waypoints from the given routing summary. The route generated by this link is not guaranteed to be the same as the route used to generate the routing summary. The link uses information provided in the request, from fields including routingParameters and searchAlongRouteParameters when applicable, to generate the directions link.

Duration

The time it takes to complete this leg of the trip.

int32

The distance of this leg of the trip.

string

Place details will be displayed with the preferred language if available. If the language code is unspecified or unrecognized, place details of any language may be returned, with a preference for English if such details exist.

Current list of supported languages: https://developers.google.com/maps/faq#languagesupport .

string

The Unicode country/region code (CLDR) of the location where the request is coming from. This parameter is used to display the place details, like region-specific place name, if available. The parameter can affect results based on applicable law.

For more information, see https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Note that 3-digit region codes are not currently supported.

string

Included Place type (eg, "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types .

Up to 50 types from Table A may be specified.

If there are any conflicting types, ie a type appears in both included_types and excluded_types, an INVALID_ARGUMENT error is returned.

If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants".

string

Excluded Place type (eg, "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types .

Up to 50 types from Table A may be specified.

If the client provides both included_types (eg restaurant) and excluded_types (eg cafe), then the response should include places that are restaurant but not cafe. The response includes places that match at least one of the included_types and none of the excluded_types.

If there are any conflicting types, ie a type appears in both included_types and excluded_types, an INVALID_ARGUMENT error is returned.

If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants".

string

Included primary Place type (eg "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types . A place can only have a single primary type from the supported types table associated with it.

Up to 50 types from Table A may be specified.

If there are any conflicting primary types, ie a type appears in both included_primary_types and excluded_primary_types, an INVALID_ARGUMENT error is returned.

If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants".

string

Excluded primary Place type (eg "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types .

Up to 50 types from Table A may be specified.

If there are any conflicting primary types, ie a type appears in both included_primary_types and excluded_primary_types, an INVALID_ARGUMENT error is returned.

If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants".

int32

Maximum number of results to return. It must be between 1 and 20 (default), inclusively. If the number is unset, it falls back to the upper limit. If the number is set to negative or exceeds the upper limit, an INVALID_ARGUMENT error is returned.

LocationRestriction

Required. The region to search.

RankPreference

How results will be ranked in the response.

RoutingParameters

Optional. Parameters that affect the routing to the search results.

bool

Optional. If true, include businesses that are not yet open but will open in the future.

Circle

A circle defined by center point and radius.

Place

A list of places that meets user's requirements like places types, number of places and specific location restriction.

RoutingSummary

A list of routing summaries where each entry associates to the corresponding place in the same index in the places field. If the routing summary is not available for one of the places, it will contain an empty entry. This list should have as many entries as the list of places if requested.

string

Required. The text query for textual search.

string

Place details will be displayed with the preferred language if available. If the language code is unspecified or unrecognized, place details of any language may be returned, with a preference for English if such details exist.

Current list of supported languages: https://developers.google.com/maps/faq#languagesupport .

string

The Unicode country/region code (CLDR) of the location where the request is coming from. This parameter is used to display the place details, like region-specific place name, if available. The parameter can affect results based on applicable law.

For more information, see https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Note that 3-digit region codes are not currently supported.

RankPreference

How results will be ranked in the response.

string

The requested place type. Full list of types supported: https://developers.google.com/maps/documentation/places/web-service/place-types . Only support one included type.

bool

Used to restrict the search to places that are currently open. The default is false.

double

Filter out results whose average user rating is strictly less than this limit. A valid value must be a float between 0 and 5 (inclusively) at a 0.5 cadence ie [0, 0.5, 1.0, ... , 5.0] inclusively. The input rating will round up to the nearest 0.5(ceiling). For instance, a rating of 0.6 will eliminate all results with a less than 1.0 rating.

int32

Deprecated: Use page_size instead.

The maximum number of results per page that can be returned. If the number of available results is larger than max_result_count , a next_page_token is returned which can be passed to page_token to get the next page of results in subsequent requests. If 0 or no value is provided, a default of 20 is used. The maximum value is 20; values above 20 will be coerced to 20. Negative values will return an INVALID_ARGUMENT error.

If both max_result_count and page_size are specified, max_result_count will be ignored.

int32

Optional. The maximum number of results per page that can be returned. If the number of available results is larger than page_size , a next_page_token is returned which can be passed to page_token to get the next page of results in subsequent requests. If 0 or no value is provided, a default of 20 is used. The maximum value is 20; values above 20 will be set to 20. Negative values will return an INVALID_ARGUMENT error.

If both max_result_count and page_size are specified, max_result_count will be ignored.

string

Optional. A page token, received from a previous TextSearch call. Provide this to retrieve the subsequent page.

When paginating, all parameters other than page_token , page_size , and max_result_count provided to TextSearch must match the initial call that provided the page token. Otherwise an INVALID_ARGUMENT error is returned.

PriceLevel

Used to restrict the search to places that are marked as certain price levels. Users can choose any combinations of price levels. Default to select all price levels.

bool

Used to set strict type filtering for included_type. If set to true, only results of the same type will be returned. Default to false.

LocationBias

The region to search. This location serves as a bias which means results around given location might be returned. Cannot be set along with location_restriction.

LocationRestriction

The region to search. This location serves as a restriction which means results outside given location will not be returned. Cannot be set along with location_bias.

EVOptions

Optional. Set the searchable EV options of a place search request.

RoutingParameters

Optional. Additional parameters for routing to results.

SearchAlongRouteParameters

Optional. Additional parameters proto for searching along a route.

bool

Optional. Include pure service area businesses if the field is set to true. Pure service area business is a business that visits or delivers to customers directly but does not serve customers at their business address. For example, businesses like cleaning services or plumbers. Those businesses do not have a physical address or location on Google Maps. Places will not return fields including location , plus_code , and other location related fields for these businesses.

bool

Optional. If true, include businesses that are not yet open but will open in the future.

double

Optional. Minimum required charging rate in kilowatts. A place with a charging rate less than the specified rate is filtered out.

EVConnectorType

Optional. The list of preferred EV connector types. A place that does not support any of the listed connector types is filtered out.

Viewport

A rectangle box defined by northeast and southwest corner. rectangle.high() must be the northeast point of the rectangle viewport. rectangle.low() must be the southwest point of the rectangle viewport. rectangle.low().latitude() cannot be greater than rectangle.high().latitude() . This will result in an empty latitude range. A rectangle viewport cannot be wider than 180 degrees.

Circle

A circle defined by center point and radius.

Viewport

A rectangle box defined by northeast and southwest corner. rectangle.high() must be the northeast point of the rectangle viewport. rectangle.low() must be the southwest point of the rectangle viewport. rectangle.low().latitude() cannot be greater than rectangle.high().latitude() . This will result in an empty latitude range. A rectangle viewport cannot be wider than 180 degrees.

Polyline

Required. The route polyline.

Place

A list of places that meet the user's text search criteria.

RoutingSummary

A list of routing summaries where each entry associates to the corresponding place in the same index in the places field. If the routing summary is not available for one of the places, it will contain an empty entry. This list will have as many entries as the list of places if requested.

ContextualContent

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

A list of contextual contents where each entry associates to the corresponding place in the same index in the places field. The contents that are relevant to the text_query in the request are preferred. If the contextual content is not available for one of the places, it will return non-contextual content. It will be empty only when the content is unavailable for this place. This list will have as many entries as the list of places if requested.

string

A token that can be sent as page_token to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.

string

A link allows the user to search with the same text query as specified in the request on Google Maps.