Package google.maps.places.v1

فهرست مطالب

مکان ها

تعریف سرویس برای Places API. توجه: هر درخواست (به جز درخواست‌های تکمیل خودکار) نیاز به یک ماسک فیلد تنظیم شده خارج از پروتوی درخواست دارد ( all/* ، فرض نمی‌شود). ماسک فیلد را می توان از طریق هدر HTTP X-Goog-FieldMask تنظیم کرد. ببینید: https://developers.google.com/maps/documentation/places/web-service/choose-fields

تکمیل خودکار مکان ها

rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse )

پیش بینی های ورودی داده شده را برمی گرداند.

GetPhotoMedia

rpc GetPhotoMedia( GetPhotoMediaRequest ) returns ( PhotoMedia )

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

GetPlace

rpc GetPlace( GetPlaceRequest ) returns ( Place )

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

جستجو در نزدیکی

rpc SearchNearby( SearchNearbyRequest ) returns ( SearchNearbyResponse )

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

SearchText

rpc SearchText( SearchTextRequest ) returns ( SearchTextResponse )

جستجوی مکان مبتنی بر پرس و جو متنی.

اعتبار نویسنده

اطلاعات مربوط به نویسنده داده های UGC. مورد استفاده در Photo و Review .

زمینه های
display_name

string

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

uri

string

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

photo_uri

string

عکس نمایه URI نویسنده Photo یا Review .

تکمیل خودکار PlacesRequest

درخواست پروتو برای AutocompletePlaces.

زمینه های
input

string

ضروری. رشته متنی که در آن جستجو می شود.

location_bias

LocationBias

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

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

location_restriction

LocationRestriction

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

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

included_primary_types[]

string

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

included_region_codes[]

string

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

language_code

string

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

region_code

string

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

origin

LatLng

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

input_offset

int32

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

اگر خالی باشد، پیش‌فرض طول input است.

include_query_predictions

bool

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

session_token

string

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

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

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

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

LocationBias

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

زمینه های

type فیلد اتحادیه

type می تواند تنها یکی از موارد زیر باشد:

rectangle

Viewport

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

circle

Circle

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

محدودیت مکان

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

زمینه های

type فیلد اتحادیه

type می تواند تنها یکی از موارد زیر باشد:

rectangle

Viewport

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

circle

Circle

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

AutocompletePlacesResponse

پروتوی پاسخ برای AutocompletePlaces.

زمینه های
suggestions[]

Suggestion

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

پیشنهاد

یک نتیجه پیشنهاد تکمیل خودکار.

زمینه های

kind میدان اتحادیه .

kind می تواند تنها یکی از موارد زیر باشد:

place_prediction

PlacePrediction

پیش بینی یک مکان

query_prediction

QueryPrediction

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

FormattableText

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

زمینه های
text

string

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

matches[]

StringRange

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

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

پیش بینی مکان

نتایج پیش‌بینی برای پیش‌بینی تکمیل خودکار مکان.

زمینه های
place

string

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

place_id

string

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

text

FormattableText

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

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

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

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

structured_format

StructuredFormat

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

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

types[]

string

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

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

distance_meters

int32

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

QueryPrediction

نتایج پیش‌بینی برای پیش‌بینی تکمیل خودکار Query.

زمینه های
text

FormattableText

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

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

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

structured_format

StructuredFormat

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

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

StringRange

یک زیر رشته را در یک متن مشخص شناسایی می کند.

زمینه های
start_offset

int32

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

end_offset

int32

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

StructuredFormat

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

برای پیش بینی مکان، متن اصلی حاوی نام خاص مکان است. برای پیش بینی پرس و جو، متن اصلی شامل پرس و جو است.

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

زمینه های
main_text

FormattableText

نشان دهنده نام مکان یا پرس و جو است.

secondary_text

FormattableText

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

دایره

دایره ای با LatLng به عنوان مرکز و شعاع.

زمینه های
center

LatLng

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

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

radius

double

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

ContentBlock

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

زمینه های
topic

string

موضوع محتوا، به عنوان مثال "نمای کلی" یا "رستوران".

content

LocalizedText

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

references

References

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

مراجعی که به این بلوک محتوا مرتبط هستند.

محتوای متنی

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

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

زمینه های
reviews[]

Review

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

photos[]

Photo

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

justifications[]

Justification

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

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

توجیه

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

توجیهات برای مکان Justifications به این سوال پاسخ می دهد که چرا یک مکان می تواند یک کاربر نهایی را مورد توجه قرار دهد.

زمینه های

justification میدانی اتحادیه .

justification تنها می تواند یکی از موارد زیر باشد:

review_justification

ReviewJustification

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

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributes توجیه

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

زمینه های
takeout

bool

اگر مکانی فراهم می کند.

delivery

bool

اگر مکانی تحویل داده شود.

dine_in

bool

اگر مکانی غذاخوری را فراهم می کند.

بازبینی توجیه

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

توجیهات بررسی کاربران این قسمتی از بررسی کاربر را برجسته می کند که برای کاربر نهایی جالب است. به عنوان مثال، اگر عبارت جستجو "پیتزا هیزم" باشد، توجیه بازبینی متن مربوط به عبارت جستجو را برجسته می کند.

زمینه های
highlighted_text

HighlightedText

review

Review

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

متن برجسته شده

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

زمینه های
text

string

highlighted_text_ranges[]

HighlightedTextRange

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

HighlightedTextRange

محدوده متن هایلایت شده

زمینه های
start_index

int32

end_index

int32

EVChargeOptions

اطلاعاتی درباره ایستگاه شارژ EV میزبانی شده در Place. اصطلاحات به شرح زیر است https://afdc.energy.gov/fuels/electricity_infrastructure.html یک پورت می تواند هر بار یک خودرو را شارژ کند. یک پورت یک یا چند کانکتور دارد. یک ایستگاه یک یا چند پورت دارد.

زمینه های
connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

فهرستی از کانکتورهای شارژ EV که حاوی کانکتورهایی با همان نوع و نرخ شارژ یکسان هستند.

ConnectorAggregation

اطلاعات شارژ EV گروه بندی شده بر اساس [نوع، max_charge_rate_kw]. تجمع شارژ EV کانکتورهایی را نشان می دهد که نوع و حداکثر نرخ شارژ را بر حسب کیلووات دارند.

زمینه های
type

EVConnectorType

نوع رابط این تجمع.

max_charge_rate_kw

double

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

count

int32

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

availability_last_update_time

Timestamp

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

available_count

int32

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

out_of_service_count

int32

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

EVConnectorType

http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 برای اطلاعات/مطالب بیشتر در مورد انواع کانکتور شارژ EV مراجعه کنید.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED کانکتور نامشخص
EV_CONNECTOR_TYPE_OTHER سایر انواع کانکتور
EV_CONNECTOR_TYPE_J1772 کانکتور J1772 نوع 1.
EV_CONNECTOR_TYPE_TYPE_2 کانکتور IEC 62196 نوع 2. اغلب به عنوان MENNEKES شناخته می شود.
EV_CONNECTOR_TYPE_CHADEMO کانکتور نوع CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 سیستم شارژ ترکیبی (AC و DC). بر اساس SAE. کانکتور نوع 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 سیستم شارژ ترکیبی (AC و DC). بر اساس کانکتور Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA کانکتور عمومی TESLA. این NACS در آمریکای شمالی است اما می‌تواند در سایر نقاط جهان غیرNACS باشد (مانند CCS Combo 2 (CCS2) یا GB/T). این مقدار کمتر معرف یک نوع اتصال دهنده واقعی است و بیشتر نشان دهنده توانایی شارژ خودروی برند تسلا در ایستگاه شارژ متعلق به تسلا است.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T نوع GB/T مطابق با استاندارد GB/T در چین است. این نوع همه انواع GB_T را پوشش می دهد.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET پریز دیواری نامشخص

گزینه های سوخت

جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود.

زمینه های
fuel_prices[]

FuelPrice

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

قیمت سوخت

اطلاعات قیمت سوخت برای یک نوع معین

زمینه های
type

FuelType

نوع سوخت.

price

Money

قیمت سوخت.

update_time

Timestamp

زمان آخرین به روز رسانی قیمت سوخت

نوع سوخت

انواع سوخت.

Enums
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزلی.
REGULAR_UNLEADED بدون سرب معمولی
MIDGRADE متوسطه.
PREMIUM حق بیمه.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE متان
BIO_DIESEL بیو دیزل.
TRUCK_DIESEL دیزل کامیون.

GetPhotoMediaRequest

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

زمینه های
name

string

ضروری. نام منبع یک رسانه عکس در قالب: places/{place_id}/photos/{photo_reference}/media .

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

max_width_px

int32

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

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

max_height_px

int32

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

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

skip_http_redirect

bool

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

GetPlaceRequest

درخواست واکشی یک مکان بر اساس نام منبع آن، که رشته‌ای در قالب places/{place_id} است.

زمینه های
name

string

ضروری. نام منبع یک مکان، در قالب places/{place_id} .

language_code

string

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

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

region_code

string

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

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

session_token

string

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

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

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

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

عکس

اطلاعات مربوط به عکس یک مکان

زمینه های
name

string

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

width_px

int32

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

height_px

int32

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

author_attributions[]

AuthorAttribution

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

PhotoMedia

یک رسانه عکس از Places API.

زمینه های
name

string

نام منبع یک رسانه عکس در قالب: places/{place_id}/photos/{photo_reference}/media .

photo_uri

string

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

محل

تمام اطلاعات نشان دهنده یک مکان.

زمینه های
name

string

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

id

string

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

display_name

LocalizedText

نام محلی مکان، مناسب به عنوان یک توصیف کوتاه قابل خواندن برای انسان. مثلاً «گوگل سیدنی»، «استارباکس»، «پیرمانت» و غیره.

types[]

string

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

primary_type

string

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

primary_type_display_name

LocalizedText

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

national_phone_number

string

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

international_phone_number

string

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

formatted_address

string

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

short_formatted_address

string

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

address_components[]

AddressComponent

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

plus_code

PlusCode

کد پلاس مکان مکان lat/long.

location

LatLng

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

viewport

Viewport

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

rating

double

امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان.

google_maps_uri

string

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

website_uri

string

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

reviews[]

Review

فهرست نظرات درباره این مکان، مرتب شده بر اساس ارتباط. حداکثر 5 نظر را می توان برگرداند.

regular_opening_hours

OpeningHours

ساعات کار منظم.

photos[]

Photo

اطلاعات (از جمله منابع) در مورد عکس های این مکان. حداکثر 10 عکس قابل بازگرداندن است.

adr_format_address

string

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

business_status

BusinessStatus

وضعیت تجاری برای مکان

price_level

PriceLevel

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

attributions[]

Attribution

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

icon_mask_base_uri

string

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

icon_background_color

string

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

current_opening_hours

OpeningHours

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

current_secondary_opening_hours[]

OpeningHours

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

regular_secondary_opening_hours[]

OpeningHours

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

editorial_summary

LocalizedText

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

payment_options

PaymentOptions

گزینه های پرداخت محل می پذیرد. اگر داده‌های گزینه پرداخت در دسترس نباشد، قسمت گزینه پرداخت تنظیم نخواهد شد.

parking_options

ParkingOptions

گزینه های پارکینگ ارائه شده توسط مکان.

sub_destinations[]

SubDestination

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

fuel_options

FuelOptions

جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود.

ev_charge_options

EVChargeOptions

اطلاعات گزینه های شارژ ev.

generative_summary

GenerativeSummary

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

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی.

area_summary

AreaSummary

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

خلاصه ای از منطقه ای که مکان در آن ایجاد شده است.

utc_offset_minutes

int32

تعداد دقیقه‌هایی که منطقه زمانی این مکان در حال حاضر از UTC خارج شده است. این در دقیقه برای پشتیبانی از مناطق زمانی بیان می‌شود که با کسری از ساعت جبران می‌شوند، به عنوان مثال X ساعت و 15 دقیقه.

user_rating_count

int32

تعداد کل نظرات (با یا بدون متن) برای این مکان.

takeout

bool

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

delivery

bool

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

dine_in

bool

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

curbside_pickup

bool

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

reservable

bool

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

serves_breakfast

bool

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

serves_lunch

bool

مشخص می کند که آیا در آن مکان ناهار سرو می شود یا خیر.

serves_dinner

bool

مشخص می کند که آیا در آن مکان شام سرو می شود.

serves_beer

bool

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

serves_wine

bool

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

serves_brunch

bool

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

serves_vegetarian_food

bool

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

outdoor_seating

bool

مکان صندلی در فضای باز فراهم می کند.

live_music

bool

مکان موسیقی زنده را ارائه می دهد.

menu_for_children

bool

مکان دارای منوی کودکان است.

serves_cocktails

bool

محل سرو کوکتل است.

serves_dessert

bool

محل سرو دسر.

serves_coffee

bool

محل سرو قهوه است.

good_for_children

bool

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

allows_dogs

bool

مکان به سگ ها اجازه می دهد.

restroom

bool

محل دارای سرویس بهداشتی

good_for_groups

bool

مکان گروه ها را در خود جای می دهد.

good_for_watching_sports

bool

مکانی برای تماشای ورزش مناسب است.

accessibility_options

AccessibilityOptions

اطلاعاتی درباره گزینه‌های دسترس‌پذیری که یک مکان ارائه می‌دهد.

گزینه های دسترسی

اطلاعاتی درباره گزینه‌های دسترس‌پذیری که یک مکان ارائه می‌دهد.

زمینه های
wheelchair_accessible_parking

bool

مکان دارای پارکینگ قابل دسترسی برای ویلچر است.

wheelchair_accessible_entrance

bool

اماکن دارای ورودی قابل دسترسی با ویلچر است.

wheelchair_accessible_restroom

bool

این مکان دارای سرویس بهداشتی قابل دسترسی برای ویلچر است.

wheelchair_accessible_seating

bool

مکان دارای صندلی های قابل دسترسی برای ویلچر است.

Address Component

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

زمینه های
long_text

string

شرح متن کامل یا نام جزء آدرس. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است دارای نام طولانی "Australia" باشد.

short_text

string

یک نام متنی مختصر برای جزء آدرس، در صورت وجود. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است نام کوتاه "AU" داشته باشد.

types[]

string

آرایه ای که نوع(های) جزء آدرس را نشان می دهد.

language_code

string

زبان مورد استفاده برای قالب بندی این مؤلفه ها، در نماد CLDR.

خلاصه منطقه

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

خلاصه ای از منطقه ای که مکان در آن ایجاد شده است.

زمینه های
content_blocks[]

ContentBlock

بلوک های محتوایی که خلاصه منطقه را تشکیل می دهند. هر بلوک یک موضوع جداگانه در مورد منطقه دارد.

انتساب

اطلاعاتی درباره ارائه دهندگان داده این مکان.

زمینه های
provider

string

نام ارائه‌دهنده داده Place.

provider_uri

string

URI به ارائه‌دهنده داده Place.

وضعیت کسب و کار

وضعیت تجاری برای مکان

Enums
BUSINESS_STATUS_UNSPECIFIED مقدار پیش فرض. این مقدار استفاده نشده است.
OPERATIONAL تأسیسات عملیاتی است، لزوماً اکنون باز نیست.
CLOSED_TEMPORARILY موسسه به طور موقت تعطیل است.
CLOSED_PERMANENTLY موسسه برای همیشه تعطیل است.

خلاصه تولیدی

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

خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی.

زمینه های
overview

LocalizedText

نمای کلی مکان.

description

LocalizedText

شرح دقیق مکان.

references

References

مراجعی که برای تولید شرح خلاصه استفاده می شود.

ساعات کار

اطلاعات مربوط به ساعت کاری محل

زمینه های
periods[]

Period

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

weekday_descriptions[]

string

رشته‌های محلی که ساعات کار این مکان را توصیف می‌کنند، یک رشته برای هر روز هفته. اگر ساعت ها ناشناخته باشند یا نتوان آنها را به متن محلی تبدیل کرد خالی خواهد بود. مثال: "Sun: 18:00-06:00"

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

اطلاعات ساختاریافته برای روزهای خاص که در دوره ای است که ساعات بازگردانده شده را پوشش می دهد. روزهای خاص روزهایی هستند که می توانند بر ساعات کاری یک مکان تأثیر بگذارند، مثلاً روز کریسمس. در صورت وجود ساعات استثنایی ، برای current_opening_hours و current_secondary_opening_hours تنظیم کنید.

open_now

bool

آیا این مکان در حال حاضر باز است؟ همیشه حضور داشته باشید مگر اینکه برای این ساعات کار فاقد داده های روزانه یا منطقه زمانی باشیم.

دوره زمانی

دوره ای که مکان در وضعیت Open_Now باقی می ماند.

زمینه های
open

Point

زمانی که مکان باز می شود.

close

Point

زمانی که مکان بسته می شود.

نقطه

تغییر وضعیت امتیاز.

زمینه های
date

Date

تاریخ در منطقه زمانی محلی برای مکان.

truncated

bool

آیا این نقطه پایانی کوتاه شده است یا نه. کوتاه شدن زمانی اتفاق می افتد که ساعات واقعی خارج از زمان است که ما مایل به بازگشت ساعت ها هستیم ، بنابراین ساعتهای برگشت به این مرزها را کوتاه می کنیم. این تضمین می کند که حداکثر 24 * 7 ساعت از نیمه شب روز درخواست بازگردانده می شود.

day

int32

یک روز از هفته ، به عنوان یک عدد صحیح در محدوده 0-6. 0 یکشنبه است ، 1 دوشنبه و غیره است.

hour

int32

ساعت در 2 رقم. محدوده از 00 تا 23.

minute

int32

دقیقه در 2 رقم. محدوده از 00 تا 59.

نوع ثانویه

نوعی استفاده شده برای شناسایی نوع ساعات ثانویه.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED مقدار پیش فرض وقتی نوع ساعت ثانویه مشخص نشده است.
DRIVE_THROUGH ساعت رانندگی برای بانک ها ، رستوران ها یا داروخانه ها.
HAPPY_HOUR ساعت مبارک
DELIVERY ساعت تحویل
TAKEOUT ساعت برداشت
KITCHEN ساعت آشپزخانه
BREAKFAST ساعت صبحانه
LUNCH ساعت ناهار
DINNER ساعت شام
BRUNCH ساعت برانک
PICKUP ساعت وانت
ACCESS ساعات دسترسی برای مکان های ذخیره سازی.
SENIOR_HOURS ساعات ویژه برای سالمندان.
ONLINE_SERVICE_HOURS ساعت خدمات آنلاین.

روز خاص

اطلاعات ساختاری برای روزهای ویژه ای که در دوره ای که ساعتهای باز برگشته است ، قرار می گیرد. روزهای ویژه روزهایی است که می تواند ساعتهای کاری یک مکان را تحت تأثیر قرار دهد ، به عنوان مثال روز کریسمس.

زمینه های
date

Date

تاریخ این روز خاص.

پارکینگ

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

زمینه های
free_parking_lot

bool

مکان پارکینگ های رایگان را ارائه می دهد.

paid_parking_lot

bool

پارکینگ های پولی را پیشنهاد می دهد.

free_street_parking

bool

Place پارکینگ خیابانی رایگان را ارائه می دهد.

paid_street_parking

bool

Place Production Parking Parking Parking.

valet_parking

bool

PLACE پارکینگ نوکر را ارائه می دهد.

free_garage_parking

bool

Place پارکینگ گاراژ رایگان را ارائه می دهد.

paid_garage_parking

bool

پارکینگ گاراژ پولی را پیشنهاد می دهد.

گزینه های پرداخت

گزینه های پرداخت مکان را می پذیرد.

زمینه های
accepts_credit_cards

bool

مکان کارتهای اعتباری را به عنوان پرداخت می پذیرد.

accepts_debit_cards

bool

مکان کارت های بدهی را به عنوان پرداخت می پذیرد.

accepts_cash_only

bool

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

accepts_nfc

bool

مکان پرداخت های NFC را می پذیرد.

کد

کد به علاوه ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد جهانی تعریف یک 14MX14M (1/8000 درجه درجه) یا مستطیل کوچکتر و کد مرکب ، جایگزین پیشوند با یک مکان مرجع.

زمینه های
global_code

string

کد جهانی (کامل) مکان ، مانند "9FWM33GV+HQ" ، نماینده 1/8000 در منطقه 1/8000 درجه (14 پوند در 14 متر).

compound_code

string

کد مرکب Place مانند "33GV+HQ ، RAMBERG ، نروژ" ، حاوی پسوند کد جهانی و جایگزین کردن پیشوند با نام فرمت یک موجود مرجع.

تعالی

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

زمینه های
name

string

نام منابع زیر مقصد.

id

string

شناسه مکان از زیر مقصد.

سطح قیمت

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

Enums
PRICE_LEVEL_UNSPECIFIED سطح قیمت مکان نامشخص یا ناشناخته است.
PRICE_LEVEL_FREE مکان خدمات رایگان ارائه می دهد.
PRICE_LEVEL_INEXPENSIVE مکان خدمات ارزان قیمت ارائه می دهد.
PRICE_LEVEL_MODERATE مکان خدمات با قیمت متوسط ​​را ارائه می دهد.
PRICE_LEVEL_EXPENSIVE مکان خدمات گران قیمت را ارائه می دهد.
PRICE_LEVEL_VERY_EXPENSIVE مکان خدمات بسیار گران قیمت را ارائه می دهد.

منابع

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

مرجعی که محتوای تولیدی مربوط به آن است.

زمینه های
reviews[]

Review

بررسی هایی که به عنوان مرجع عمل می کنند.

places[]

string

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

مرور

اطلاعات مربوط به بررسی یک مکان.

زمینه های
name

string

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

relative_publish_time_description

string

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

text

LocalizedText

متن بومی شده بررسی.

original_text

LocalizedText

متن نقد و بررسی به زبان اصلی آن.

rating

double

تعدادی بین 1.0 تا 5.0 ، که به آن تعداد ستاره ها نیز گفته می شود.

author_attribution

AuthorAttribution

نویسنده این بررسی

publish_time

Timestamp

Timestamp برای بررسی.

SearchNearByRequest

درخواست Proto برای جستجو در این نزدیکی کنید.

زمینه های
language_code

string

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

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

region_code

string

کد کشور/منطقه یونیکد (CLDR) از مکانی که درخواست از آن می آید. این پارامتر برای نمایش جزئیات مکان ، مانند نام مکان خاص ، در صورت وجود استفاده می شود. این پارامتر می تواند بر اساس قانون قابل اجرا بر نتایج تأثیر بگذارد.

برای اطلاعات بیشتر ، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید.

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

included_types[]

string

شامل نوع مکان (به عنوان مثال ، "رستوران" یا "gas_station") از https://developers.google.com/maps/documentation/places/web-service/place-types .

حداکثر 50 نوع از جدول A ممکن است مشخص شود.

اگر انواع متناقض وجود داشته باشد ، IE یک نوع در هر دو مورد در هر دو مورد - types و ududed_types ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود.

اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند.

excluded_types[]

string

نوع مکان مستثنی (به عنوان مثال ، "رستوران" یا "gas_station") از https://developers.google.com/maps/documentation/places/web-service/place-types .

حداکثر 50 نوع از جدول A ممکن است مشخص شود.

اگر مشتری هر دو شامل_تایپ (به عنوان مثال رستوران) و Stuckuded_types (به عنوان مثال کافه) را ارائه دهد ، پاسخ باید شامل مکانهایی باشد که رستوران هستند اما کافه نیستند. این پاسخ شامل مکانهایی است که حداقل با یکی از موارد شامل_تایپ و هیچکدام از موارد حذف شده مطابقت ندارد.

اگر انواع متناقض وجود داشته باشد ، IE یک نوع در هر دو مورد در هر دو مورد - types و ududed_types ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود.

اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند.

included_primary_types[]

string

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

حداکثر 50 نوع از جدول A ممکن است مشخص شود.

اگر انواع اولیه متناقض وجود داشته باشد ، یعنی یک نوع در هر دو مورد شامل_پریپه ها و حذف شده_پریپه ها ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود.

اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند.

excluded_primary_types[]

string

از نوع مکان اصلی حذف شده (به عنوان مثال "رستوران" یا "GAS_STATION") از https://developers.google.com/maps/documentation/places/web-service/place-types .

حداکثر 50 نوع از جدول A ممکن است مشخص شود.

اگر انواع اولیه متناقض وجود داشته باشد ، یعنی یک نوع در هر دو مورد شامل_پریپه ها و حذف شده_پریپه ها ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود.

اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند.

max_result_count

int32

حداکثر تعداد نتایج برای بازگشت. این باید بین 1 تا 20 (به طور پیش فرض) باشد. اگر عدد ناشناخته باشد ، به حد بالایی باز می گردد. اگر عدد بر روی منفی تنظیم شود یا از حد بالایی فراتر رود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود.

location_restriction

LocationRestriction

ضروری. منطقه برای جستجو.

rank_preference

RankPreference

چگونه نتایج در پاسخ رتبه بندی می شود.

محل کار

منطقه برای جستجو.

زمینه های

type میدان اتحادیه.

type فقط می تواند یکی از موارد زیر باشد:

circle

Circle

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

پیشران

چگونه نتایج در پاسخ رتبه بندی می شود.

Enums
RANK_PREFERENCE_UNSPECIFIED مقدار RankPreference تنظیم نشده است. به طور پیش فرض از درجه محبوبیت استفاده خواهد کرد.
DISTANCE نتایج را با فاصله از بین می برد.
POPULARITY نتایج را با محبوبیت رتبه بندی می کند.

پاسخ searchnearbyresponse

پاسخ پروتئین برای جستجو در این نزدیکی.

زمینه های
places[]

Place

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

SearchTextrequest

درخواست proto برای searchText.

زمینه های
text_query

string

ضروری. پرس و جو متن برای جستجوی متنی.

language_code

string

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

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

region_code

string

کد کشور/منطقه یونیکد (CLDR) از مکانی که درخواست از آن می آید. این پارامتر برای نمایش جزئیات مکان ، مانند نام مکان خاص ، در صورت وجود استفاده می شود. این پارامتر می تواند بر اساس قانون قابل اجرا بر نتایج تأثیر بگذارد.

برای اطلاعات بیشتر ، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید.

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

rank_preference

RankPreference

چگونه نتایج در پاسخ رتبه بندی می شود.

included_type

string

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

open_now

bool

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

min_rating

double

نتایج را فیلتر کنید که میانگین امتیاز کاربر آن کاملاً کمتر از این حد است. یک مقدار معتبر باید یک شناور بین 0 تا 5 (به طور گسترده) در 0.5 Cadence IE باشد [0 ، 0.5 ، 1.0 ، ... ، 5.0]. رتبه ورودی تا نزدیکترین 0.5 (سقف) دور خواهد شد. به عنوان مثال ، امتیاز 0.6 تمام نتایج را با امتیاز کمتر از 1.0 از بین می برد.

max_result_count
(deprecated)

int32

deprecated: به جای آن از page_size استفاده کنید.

حداکثر تعداد نتایج در هر صفحه که می تواند برگردانده شود. اگر تعداد نتایج موجود از max_result_count بزرگتر باشد ، یک next_page_token بازگردانده می شود که می تواند برای دریافت صفحه بعدی نتایج در درخواست های بعدی به page_token منتقل شود. اگر 0 یا هیچ مقدار ارائه شود ، از پیش فرض 20 استفاده می شود. حداکثر مقدار 20 است. مقادیر بالاتر از 20 به 20 مورد اجبار خواهد بود. مقادیر منفی یک خطای نامعتبر را برمی گرداند.

اگر هر دو max_result_count و page_size مشخص شوند ، max_result_count نادیده گرفته می شود.

page_size

int32

اختیاری. حداکثر تعداد نتایج در هر صفحه که می تواند برگردانده شود. اگر تعداد نتایج موجود از page_size بزرگتر باشد ، یک next_page_token بازگردانده می شود که می تواند برای دریافت صفحه بعدی نتایج در درخواست های بعدی به page_token منتقل شود. اگر 0 یا هیچ مقدار ارائه شود ، از پیش فرض 20 استفاده می شود. حداکثر مقدار 20 است. مقادیر بالاتر از 20 بر روی 20 تنظیم می شود. مقادیر منفی یک خطای نامعتبر را برمی گرداند.

اگر هر دو max_result_count و page_size مشخص شوند ، max_result_count نادیده گرفته می شود.

page_token

string

اختیاری. یک نشان صفحه ، از یک تماس قبلی TextSearch دریافت شده است. این کار را برای بازیابی صفحه بعدی ارائه دهید.

هنگام پیگیری ، تمام پارامترهای غیر از page_token ، page_size و max_result_count ارائه شده به textsearch باید با تماس اولیه که نشانه صفحه را فراهم می کند مطابقت داشته باشد. در غیر این صورت یک خطای نامعتبر_ارگنت بازگردانده می شود.

price_levels[]

PriceLevel

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

strict_type_filtering

bool

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

location_bias

LocationBias

منطقه برای جستجو. این مکان به عنوان یک تعصب عمل می کند و این بدان معناست که نتایج اطراف مکان ممکن است برگردانده شود. نمی توان همراه با مکان_ restriction تنظیم کرد.

location_restriction

LocationRestriction

منطقه برای جستجو. این مکان به عنوان یک محدودیت عمل می کند و این بدان معنی است که نتایج خارج از مکان بازگردانده نمی شود. نمی توان همراه با مکان_بیا تنظیم کرد.

ev_options

EVOptions

اختیاری. گزینه های EV قابل جستجو درخواست جستجوی مکان را تنظیم کنید.

اگلها

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

زمینه های
minimum_charging_rate_kw

double

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

connector_types[]

EVConnectorType

اختیاری. لیست انواع اتصال دهنده EV. مکانی که از هیچ یک از انواع کانکتور ذکر شده پشتیبانی نمی کند ، فیلتر می شود.

مکان یابی

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

زمینه های

type میدان اتحادیه.

type فقط می تواند یکی از موارد زیر باشد:

rectangle

Viewport

یک جعبه مستطیل تعریف شده توسط گوشه شمال شرقی و جنوب غربی. rectangle.high() باید نقطه شمال شرقی نمای مستطیل باشد. rectangle.low() باید نقطه جنوب غربی نمای مستطیل باشد. rectangle.low().latitude() نمی تواند بیشتر از rectangle.high().latitude() باشد. این منجر به یک محدوده عرض جغرافیایی خالی خواهد شد. نمای مستطیل نمی تواند گسترده تر از 180 درجه باشد.

circle

Circle

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

محل کار

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

زمینه های

type میدان اتحادیه.

type فقط می تواند یکی از موارد زیر باشد:

rectangle

Viewport

یک جعبه مستطیل تعریف شده توسط گوشه شمال شرقی و جنوب غربی. rectangle.high() باید نقطه شمال شرقی نمای مستطیل باشد. rectangle.low() باید نقطه جنوب غربی نمای مستطیل باشد. rectangle.low().latitude() نمی تواند بیشتر از rectangle.high().latitude() باشد. این منجر به یک محدوده عرض جغرافیایی خالی خواهد شد. نمای مستطیل نمی تواند گسترده تر از 180 درجه باشد.

پیشران

چگونه نتایج در پاسخ رتبه بندی می شود.

Enums
RANK_PREFERENCE_UNSPECIFIED برای یک پرس و جو طبقه بندی مانند "رستوران ها در شهر نیویورک" ، ارتباط پیش فرض است. برای نمایش داده های غیر گروهی مانند "Mountain View ، CA" توصیه می کنیم که RankPreference UNSET را ترک کنید.
DISTANCE نتایج را با فاصله از بین می برد.
RELEVANCE نتایج را با توجه به رتبه بندی می کند. ترتیب مرتب سازی شده توسط پشته رتبه بندی عادی.

پاسخ

پاسخ پروتئین برای متن جستجو.

زمینه های
places[]

Place

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

contextual_contents[]

ContextualContent

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

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

next_page_token

string

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