فهرست مطالب
-
Places
(رابط) -
AuthorAttribution
(پیام) -
AutocompletePlacesRequest
(پیام) -
AutocompletePlacesRequest.LocationBias
(پیام) -
AutocompletePlacesRequest.LocationRestriction
(پیام) -
AutocompletePlacesResponse
(پیام) -
AutocompletePlacesResponse.Suggestion
(پیام) -
AutocompletePlacesResponse.Suggestion.FormattableText
(پیام) -
AutocompletePlacesResponse.Suggestion.PlacePrediction
(پیام) -
AutocompletePlacesResponse.Suggestion.QueryPrediction
(پیام) -
AutocompletePlacesResponse.Suggestion.StringRange
(پیام) -
AutocompletePlacesResponse.Suggestion.StructuredFormat
(پیام) -
Circle
(پیام) -
ContentBlock
(پیام) -
ContextualContent
(پیام) -
ContextualContent.Justification
(پیام) -
ContextualContent.Justification.BusinessAvailabilityAttributesJustification
(پیام) -
ContextualContent.Justification.ReviewJustification
(پیام) -
ContextualContent.Justification.ReviewJustification.HighlightedText
(پیام) -
ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange
(پیام) -
EVChargeOptions
(پیام) -
EVChargeOptions.ConnectorAggregation
(پیام) -
EVConnectorType
(enum) -
FuelOptions
(پیام) -
FuelOptions.FuelPrice
(پیام) -
FuelOptions.FuelPrice.FuelType
(تعدادی) -
GetPhotoMediaRequest
(پیام) -
GetPlaceRequest
(پیام) -
Photo
(پیام) -
PhotoMedia
(پیام) -
Place
(پیام) -
Place.AccessibilityOptions
(پیام) -
Place.AddressComponent
(پیام) -
Place.AreaSummary
(پیام) -
Place.Attribution
(پیام) -
Place.BusinessStatus
(مجموعه) -
Place.GenerativeSummary
(پیام) -
Place.OpeningHours
(پیام) -
Place.OpeningHours.Period
(پیام) -
Place.OpeningHours.Period.Point
(پیام) -
Place.OpeningHours.SecondaryHoursType
(enum) -
Place.OpeningHours.SpecialDay
(پیام) -
Place.ParkingOptions
(پیام) -
Place.PaymentOptions
(پیام) -
Place.PlusCode
(پیام) -
Place.SubDestination
(پیام) -
PriceLevel
(تعدادی) -
References
(پیام) -
Review
(پیام) -
SearchNearbyRequest
(پیام) -
SearchNearbyRequest.LocationRestriction
(پیام) -
SearchNearbyRequest.RankPreference
(enum) -
SearchNearbyResponse
(پیام) -
SearchTextRequest
(پیام) -
SearchTextRequest.EVOptions
(پیام) -
SearchTextRequest.LocationBias
(پیام) -
SearchTextRequest.LocationRestriction
(پیام) -
SearchTextRequest.RankPreference
(enum) -
SearchTextResponse
(پیام)
مکان ها
تعریف سرویس برای Places API. توجه: هر درخواست (به جز درخواستهای تکمیل خودکار) نیاز به یک ماسک فیلد تنظیم شده خارج از پروتوی درخواست دارد ( all/*
، فرض نمیشود). ماسک فیلد را می توان از طریق هدر HTTP X-Goog-FieldMask
تنظیم کرد. ببینید: https://developers.google.com/maps/documentation/places/web-service/choose-fields
تکمیل خودکار مکان ها |
---|
پیش بینی های ورودی داده شده را برمی گرداند. |
GetPhotoMedia |
---|
یک رسانه عکس با رشته مرجع عکس دریافت کنید. |
GetPlace |
---|
جزئیات یک مکان را بر اساس نام منبع آن، که رشتهای در قالب |
جستجو در نزدیکی |
---|
مکان های نزدیک به مکان ها را جستجو کنید. |
SearchText |
---|
جستجوی مکان مبتنی بر پرس و جو متنی. |
اعتبار نویسنده
اطلاعات مربوط به نویسنده داده های UGC. مورد استفاده در Photo
و Review
.
زمینه های | |
---|---|
display_name | |
uri | |
photo_uri | |
تکمیل خودکار PlacesRequest
درخواست پروتو برای AutocompletePlaces.
زمینه های | |
---|---|
input | ضروری. رشته متنی که در آن جستجو می شود. |
location_bias | اختیاری. سوگیری به یک مکان مشخص منجر می شود. حداکثر باید یکی از |
location_restriction | اختیاری. نتایج را به یک مکان مشخص محدود کنید. حداکثر باید یکی از |
included_primary_types[] | اختیاری. شامل نوع مکان اصلی (به عنوان مثال، "رستوران" یا "گاز_پمپ") از https://developers.google.com/maps/documentation/places/web-service/place-types . یک مکان تنها در صورتی برگردانده می شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 5 مقدار قابل تعیین است. اگر هیچ نوع مشخصی وجود نداشته باشد، همه انواع Place برگردانده می شوند. |
included_region_codes[] | اختیاری. فقط شامل نتایج در مناطق مشخص شده، مشخص شده به عنوان حداکثر 15 کد منطقه دو نویسه CLDR. مجموعه خالی نتایج را محدود نمی کند. اگر هر دو |
language_code | اختیاری. زبانی که در آن نتایج را برگرداند. پیشفرضها به en-US. اگر زبان مورد استفاده در |
region_code | اختیاری. کد منطقه که به عنوان کد منطقه دو کاراکتری CLDR مشخص شده است. این بر قالببندی آدرس، رتبهبندی نتایج تأثیر میگذارد و ممکن است بر نتایجی که برگردانده میشوند تأثیر بگذارد. این نتایج را به منطقه مشخص شده محدود نمی کند. برای محدود کردن نتایج به یک منطقه، از |
origin | اختیاری. نقطه مبدا که از آن فاصله ژئودزیکی تا مقصد محاسبه می شود (به عنوان |
input_offset | اختیاری. یک افست نویسه یونیکد مبتنی بر صفر از اگر خالی باشد، پیشفرض طول |
include_query_predictions | اختیاری. اگر درست باشد، پاسخ شامل پیشبینی مکان و پرس و جو میشود. در غیر این صورت پاسخ فقط پیش بینی های مکان را برمی گرداند. |
session_token | اختیاری. رشته ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می کند. باید یک URL و نام فایل ایمن رشته base64 با حداکثر 36 کاراکتر اسکی باشد. در غیر این صورت یک خطای INVALID_ARGUMENT برگردانده می شود. جلسه زمانی شروع می شود که کاربر شروع به تایپ یک پرس و جو می کند، و زمانی که مکان را انتخاب می کند و تماسی با جزئیات مکان یا اعتبار سنجی آدرس برقرار می شود، به پایان می رسد. هر جلسه میتواند چندین پرسوجو داشته باشد و به دنبال آن یک درخواست جزییات مکان یا اعتبار سنجی آدرس ارائه شود. اعتبار استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر ما دستورالعمل های زیر را توصیه می کنیم:
|
LocationBias
منطقه ای برای جستجو نتایج ممکن است حول منطقه مشخص شده تعصب داشته باشند.
زمینه های | |
---|---|
| |
rectangle | یک نما که توسط یک گوشه شمال شرقی و یک گوشه جنوب غربی تعریف شده است. |
circle | دایره ای که با نقطه مرکزی و شعاع مشخص می شود. |
محدودیت مکان
منطقه ای برای جستجو نتایج به منطقه مشخص شده محدود خواهد شد.
زمینه های | |
---|---|
| |
rectangle | یک نما که توسط یک گوشه شمال شرقی و یک گوشه جنوب غربی تعریف شده است. |
circle | دایره ای که با نقطه مرکزی و شعاع مشخص می شود. |
AutocompletePlacesResponse
پروتوی پاسخ برای AutocompletePlaces.
زمینه های | |
---|---|
suggestions[] | حاوی فهرستی از پیشنهادات است که به ترتیب نزولی مرتبط مرتب شده اند. |
پیشنهاد
یک نتیجه پیشنهاد تکمیل خودکار.
زمینه های | |
---|---|
| |
place_prediction | پیش بینی یک مکان |
query_prediction | یک پیش بینی برای یک پرس و جو |
FormattableText
متنی که یک پیشبینی مکان یا پرس و جو را نشان میدهد. متن ممکن است همانطور که هست یا قالب بندی شده استفاده شود.
زمینه های | |
---|---|
text | متنی که ممکن است همانطور که هست استفاده شود یا با |
matches[] | فهرستی از محدودههای رشتهای که محل مطابقت درخواست ورودی در این مقادیر، افست کاراکترهای یونیکد |
پیش بینی مکان
نتایج پیشبینی برای پیشبینی تکمیل خودکار مکان.
زمینه های | |
---|---|
place | نام منبع مکان پیشنهادی. این نام را می توان در سایر APIهایی که نام مکان را می پذیرند استفاده کرد. |
place_id | شناسه منحصر به فرد مکان پیشنهادی. این شناسه را می توان در سایر APIهایی که شناسه مکان را می پذیرند استفاده کرد. |
text | حاوی نام قابل خواندن توسط انسان برای نتیجه برگشتی است. برای نتایج تاسیس، این معمولاً نام و آدرس کسب و کار است. این متن ممکن است با اگر |
structured_format | تفکیک پیشبینی مکان به متن اصلی حاوی نام مکان و متن ثانویه حاوی ویژگیهای ابهامزدایی اضافی (مانند شهر یا منطقه). |
types[] | فهرست انواعی که برای این مکان از جدول A یا جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types اعمال می شود. نوع، دسته بندی یک مکان است. مکانهایی با انواع مشترک ویژگیهای مشابهی دارند. |
distance_meters | طول ژئودزیک بر حسب متر از |
QueryPrediction
نتایج پیشبینی برای پیشبینی تکمیل خودکار Query.
زمینه های | |
---|---|
text | متن پیش بینی شده این متن نشان دهنده یک مکان نیست، بلکه یک پرس و جو متنی است که می تواند در یک نقطه پایانی جستجو (به عنوان مثال، جستجوی متن) استفاده شود. اگر |
structured_format | تفکیک پیشبینی پرس و جو به متن اصلی حاوی پرس و جو و متن ثانویه حاوی ویژگیهای ابهامزدایی اضافی (مانند شهر یا منطقه). |
StringRange
یک زیر رشته را در یک متن مشخص شناسایی می کند.
زمینه های | |
---|---|
start_offset | آفست مبتنی بر صفر اولین کاراکتر یونیکد رشته (شامل). |
end_offset | افست بر اساس صفر آخرین کاراکتر یونیکد (انحصاری). |
StructuredFormat
شامل تفکیک یک مکان یا پیشبینی پرس و جو به متن اصلی و متن فرعی است.
برای پیش بینی مکان، متن اصلی حاوی نام خاص مکان است. برای پیش بینی پرس و جو، متن اصلی شامل پرس و جو است.
متن ثانویه حاوی ویژگیهای ابهامزدایی اضافی (مانند شهر یا منطقه) برای شناسایی بیشتر مکان یا اصلاح درخواست است.
زمینه های | |
---|---|
main_text | نشان دهنده نام مکان یا پرس و جو است. |
secondary_text | نمایانگر ویژگیهای ابهامزدایی اضافی (مانند یک شهر یا منطقه) برای شناسایی بیشتر مکان یا اصلاح درخواست است. |
دایره
دایره ای با LatLng به عنوان مرکز و شعاع.
زمینه های | |
---|---|
center | ضروری. طول و عرض جغرافیایی مرکز. محدوده عرض جغرافیایی باید در [90.0-، 90.0] باشد. محدوده طول جغرافیایی باید در محدوده [-180.0، 180.0] باشد. |
radius | ضروری. شعاع بر حسب متر اندازه گیری می شود. شعاع باید در [0.0، 50000.0] باشد. |
ContentBlock
بلوکی از محتوا که می تواند به صورت جداگانه ارائه شود.
زمینه های | |
---|---|
topic | موضوع محتوا، به عنوان مثال "نمای کلی" یا "رستوران". |
content | مطالب مرتبط با موضوع |
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[] | فهرست نظرات درباره این مکان، مرتبط با جستجوی مکان. |
photos[] | اطلاعات (از جمله مراجع) درباره عکسهای این مکان، مرتبط با جستار مکان. |
justifications[] | آزمایشی: برای جزئیات بیشتر به 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 به این سوال پاسخ می دهد که چرا یک مکان می تواند یک کاربر نهایی را مورد توجه قرار دهد.
زمینه های | |
---|---|
| |
review_justification | آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید. |
business_availability_attributes_justification | آزمایشی: برای جزئیات بیشتر به 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 | اگر مکانی فراهم می کند. |
delivery | اگر مکانی تحویل داده شود. |
dine_in | اگر مکانی غذاخوری را فراهم می کند. |
بازبینی توجیه
آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.
توجیهات بررسی کاربران این قسمتی از بررسی کاربر را برجسته می کند که برای کاربر نهایی جالب است. به عنوان مثال، اگر عبارت جستجو "پیتزا هیزم" باشد، توجیه بازبینی متن مربوط به عبارت جستجو را برجسته می کند.
زمینه های | |
---|---|
highlighted_text | |
review | مروری که متن برجسته شده از آن ایجاد شده است. |
متن برجسته شده
متن برجسته شده توسط توجیه. این زیر مجموعه ای از خود بررسی است. کلمه دقیقی که باید برجسته شود با HighlightedTextRange مشخص می شود. ممکن است چندین کلمه در متن برجسته شده باشد.
زمینه های | |
---|---|
text | |
highlighted_text_ranges[] | فهرست محدوده های متن برجسته شده. |
HighlightedTextRange
محدوده متن هایلایت شده
زمینه های | |
---|---|
start_index | |
end_index | |
EVChargeOptions
اطلاعاتی درباره ایستگاه شارژ EV میزبانی شده در Place. اصطلاحات به شرح زیر است https://afdc.energy.gov/fuels/electricity_infrastructure.html یک پورت می تواند هر بار یک خودرو را شارژ کند. یک پورت یک یا چند کانکتور دارد. یک ایستگاه یک یا چند پورت دارد.
زمینه های | |
---|---|
connector_count | تعداد کانکتورها در این ایستگاه با این حال، از آنجایی که برخی از پورت ها می توانند چندین کانکتور داشته باشند اما فقط می توانند یک خودرو را در یک زمان شارژ کنند (مثلاً) تعداد کانکتورها ممکن است بیشتر از تعداد کل ماشین هایی باشد که می توانند همزمان شارژ شوند. |
connector_aggregation[] | فهرستی از کانکتورهای شارژ EV که حاوی کانکتورهایی با همان نوع و نرخ شارژ یکسان هستند. |
ConnectorAggregation
اطلاعات شارژ EV گروه بندی شده بر اساس [نوع، max_charge_rate_kw]. تجمع شارژ EV کانکتورهایی را نشان می دهد که نوع و حداکثر نرخ شارژ را بر حسب کیلووات دارند.
زمینه های | |
---|---|
type | نوع رابط این تجمع. |
max_charge_rate_kw | حداکثر نرخ شارژ استاتیک به کیلووات هر کانکتور در تجمع. |
count | تعداد کانکتورها در این تجمع. |
availability_last_update_time | مهر زمانی آخرین بهروزرسانی اطلاعات در دسترس بودن رابط در این مجموعه. |
available_count | تعداد رابطهای موجود در این مجموعه که در حال حاضر در دسترس هستند. |
out_of_service_count | تعداد رابطهای موجود در این مجموعه که در حال حاضر از سرویس خارج هستند. |
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[] | آخرین قیمت سوخت شناخته شده برای هر نوع سوخت این جایگاه. برای هر نوع سوخت این جایگاه یک ورودی وجود دارد. ترتیب مهم نیست |
قیمت سوخت
اطلاعات قیمت سوخت برای یک نوع معین
زمینه های | |
---|---|
type | نوع سوخت. |
price | قیمت سوخت. |
update_time | زمان آخرین به روز رسانی قیمت سوخت |
نوع سوخت
انواع سوخت.
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 | ضروری. نام منبع یک رسانه عکس در قالب: نام منبع عکسی که در فیلد |
max_width_px | اختیاری. حداکثر عرض مورد نظر تصویر را بر حسب پیکسل مشخص می کند. اگر تصویر کوچکتر از مقادیر مشخص شده باشد، تصویر اصلی برگردانده می شود. اگر تصویر در هر یک از ابعاد بزرگتر باشد، برای مطابقت با ابعاد کوچکتر از دو بعد، محدود به نسبت تصویر اصلی آن، مقیاس بندی می شود. هر دو ویژگی 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 | اختیاری. حداکثر ارتفاع مورد نظر تصویر را بر حسب پیکسل مشخص می کند. اگر تصویر کوچکتر از مقادیر مشخص شده باشد، تصویر اصلی برگردانده می شود. اگر تصویر در هر یک از ابعاد بزرگتر باشد، برای مطابقت با ابعاد کوچکتر از دو بعد، محدود به نسبت تصویر اصلی آن، مقیاس بندی می شود. هر دو ویژگی 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 | اختیاری. در صورت تنظیم، از رفتار پیشفرض تغییر مسیر HTTP صرفنظر کنید و یک قالب متنی (مثلاً در قالب JSON برای موارد استفاده HTTP) ارائه دهید. اگر تنظیم نشود، یک تغییر مسیر HTTP برای هدایت تماس به رسانه تصویر صادر می شود. این گزینه برای درخواست های غیر HTTP نادیده گرفته می شود. |
GetPlaceRequest
درخواست واکشی یک مکان بر اساس نام منبع آن، که رشتهای در قالب places/{place_id}
است.
زمینه های | |
---|---|
name | ضروری. نام منبع یک مکان، در قالب |
language_code | اختیاری. جزئیات مکان در صورت وجود با زبان ترجیحی نمایش داده می شود. لیست فعلی زبان های پشتیبانی شده: https://developers.google.com/maps/faq#languagesupport . |
region_code | اختیاری. کد کشور/منطقه یونیکد (CLDR) مکانی که درخواست از آنجا می آید. این پارامتر برای نمایش جزئیات مکان، مانند نام مکان خاص منطقه، در صورت وجود استفاده می شود. این پارامتر می تواند بر نتایج بر اساس قانون قابل اجرا تأثیر بگذارد. برای اطلاعات بیشتر، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید. توجه داشته باشید که کدهای منطقه 3 رقمی در حال حاضر پشتیبانی نمی شوند. |
session_token | اختیاری. رشته ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می کند. باید یک URL و نام فایل ایمن رشته base64 با حداکثر 36 کاراکتر اسکی باشد. در غیر این صورت یک خطای INVALID_ARGUMENT برگردانده می شود. جلسه زمانی شروع می شود که کاربر شروع به تایپ یک پرس و جو می کند، و زمانی که مکان را انتخاب می کند و تماسی با جزئیات مکان یا اعتبار سنجی آدرس برقرار می شود، به پایان می رسد. هر جلسه میتواند چندین پرسوجو داشته باشد و به دنبال آن یک درخواست جزییات مکان یا اعتبار سنجی آدرس ارائه شود. اعتبار استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر ما دستورالعمل های زیر را توصیه می کنیم:
|
عکس
اطلاعات مربوط به عکس یک مکان
زمینه های | |
---|---|
name | مشخص کننده. مرجعی که این عکس مکان را نشان می دهد که ممکن است برای جستجوی دوباره این عکس مکان استفاده شود (همچنین نام "منبع" API نیز نامیده می شود: |
width_px | حداکثر عرض موجود، بر حسب پیکسل. |
height_px | حداکثر ارتفاع موجود، بر حسب پیکسل. |
author_attributions[] | نویسندگان این عکس |
PhotoMedia
یک رسانه عکس از Places API.
زمینه های | |
---|---|
name | نام منبع یک رسانه عکس در قالب: |
photo_uri | اوری کوتاه مدت که می توان از آن برای رندر عکس استفاده کرد. |
محل
تمام اطلاعات نشان دهنده یک مکان.
زمینه های | |
---|---|
name | نام منبع این مکان، در قالب |
id | شناسه منحصر به فرد یک مکان. |
display_name | نام محلی مکان، مناسب به عنوان یک توصیف کوتاه قابل خواندن برای انسان. مثلاً «گوگل سیدنی»، «استارباکس»، «پیرمانت» و غیره. |
types[] | مجموعه ای از برچسب های نوع برای این نتیجه. مثلاً «سیاسی» و «محلی». برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید. |
primary_type | نوع اولیه نتیجه داده شده. این نوع باید یکی از انواع Places API پشتیبانی شده باشد. مثلاً «رستوران»، «کافه»، «فرودگاه» و ... یک مکان فقط می تواند یک نوع اولیه داشته باشد. برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید. |
primary_type_display_name | نام نمایشی نوع اصلی که در صورت وجود به زبان درخواست ترجمه شده است. برای فهرست کامل مقادیر ممکن، به جدول A و جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید. |
national_phone_number | یک شماره تلفن قابل خواندن توسط انسان برای مکان، در قالب ملی. |
international_phone_number | یک شماره تلفن قابل خواندن توسط انسان برای مکان، در قالب بین المللی. |
formatted_address | آدرسی کامل و قابل خواندن برای انسان برای این مکان. |
short_formatted_address | آدرسی کوتاه و قابل خواندن برای انسان برای این مکان. |
address_components[] | اجزای مکرر برای هر سطح محلی. به حقایق زیر در مورد آرایه address_components[] توجه کنید: - آرایه اجزای آدرس ممکن است اجزای بیشتری نسبت به آدرس_formated داشته باشد. - این آرایه لزوماً شامل همه نهادهای سیاسی که دارای یک آدرس هستند، به غیر از موارد موجود در آدرس_formated نمی شود. برای بازیابی تمام نهادهای سیاسی که حاوی یک آدرس خاص هستند، باید از رمزگذاری جغرافیایی معکوس استفاده کنید و عرض/طول جغرافیایی آدرس را به عنوان پارامتری برای درخواست ارسال کنید. - فرمت پاسخ تضمینی برای ثابت ماندن بین درخواست ها وجود ندارد. به طور خاص، تعداد address_components بر اساس آدرس درخواستی متفاوت است و می تواند در طول زمان برای همان آدرس تغییر کند. یک جزء می تواند موقعیت خود را در آرایه تغییر دهد. نوع جزء می تواند تغییر کند. ممکن است یک جزء خاص در پاسخ بعدی گم شده باشد. |
plus_code | کد پلاس مکان مکان lat/long. |
location | موقعیت این مکان. |
viewport | یک نمای مناسب برای نمایش مکان در یک نقشه با اندازه متوسط. |
rating | امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان. |
google_maps_uri | نشانی اینترنتی که اطلاعات بیشتری درباره این مکان ارائه میکند. |
website_uri | وب سایت معتبر برای این مکان، به عنوان مثال صفحه اصلی یک کسب و کار. توجه داشته باشید که برای مکانهایی که بخشی از یک زنجیره هستند (مثلاً یک فروشگاه IKEA)، این معمولاً وبسایت فروشگاه فردی است، نه زنجیره کلی. |
reviews[] | فهرست نظرات درباره این مکان، مرتب شده بر اساس ارتباط. حداکثر 5 نظر را می توان برگرداند. |
regular_opening_hours | ساعات کار منظم. |
photos[] | اطلاعات (از جمله منابع) در مورد عکس های این مکان. حداکثر 10 عکس قابل بازگرداندن است. |
adr_format_address | آدرس مکان در میکروفرمت adr: http://microformats.org/wiki/adr . |
business_status | وضعیت تجاری برای مکان |
price_level | سطح قیمت مکان. |
attributions[] | مجموعه ای از ارائه دهنده داده که باید با این نتیجه نشان داده شود. |
icon_mask_base_uri | یک URL کوتاه شده به یک ماسک نماد. کاربر می تواند با اضافه کردن پسوند نوع به انتها (به عنوان مثال، ".svg" یا ".png") به انواع نمادهای مختلف دسترسی پیدا کند. |
icon_background_color | رنگ پس زمینه برای icon_mask در فرمت هگز، به عنوان مثال #909CE1. |
current_opening_hours | ساعات کار برای هفت روز آینده (از جمله امروز). دوره زمانی از نیمه شب تاریخ درخواست شروع می شود و شش روز بعد در ساعت 23:59 پایان می یابد. این فیلد شامل زیرفیلد special_days همه ساعتها است که برای تاریخهایی که ساعات استثنایی دارند تنظیم شده است. |
current_secondary_opening_hours[] | شامل مجموعه ای از ورودی ها برای هفت روز آینده از جمله اطلاعات مربوط به ساعات ثانویه یک کسب و کار. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند. این فیلد زیرفیلد نوع را پر می کند، که از یک لیست از پیش تعریف شده از انواع ساعات کاری (مانند DRIVE_THROUGH، PICKUP، یا TAKEOUT) بر اساس انواع مکان استخراج می شود. این فیلد شامل زیرفیلد special_days همه ساعتها است که برای تاریخهایی که ساعات استثنایی دارند تنظیم شده است. |
regular_secondary_opening_hours[] | شامل مجموعهای از ورودیها برای اطلاعات مربوط به ساعات کاری عادی یک کسبوکار است. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند. این فیلد زیرفیلد نوع را پر می کند، که از یک لیست از پیش تعریف شده از انواع ساعات کاری (مانند DRIVE_THROUGH، PICKUP، یا TAKEOUT) بر اساس انواع مکان استخراج می شود. |
editorial_summary | شامل خلاصه ای از مکان است. خلاصه از یک نمای کلی متنی تشکیل شده است و در صورت لزوم، کد زبان آن را نیز در بر می گیرد. متن خلاصه باید همانطور که هست ارائه شود و قابل تغییر یا تغییر نیست. |
payment_options | گزینه های پرداخت محل می پذیرد. اگر دادههای گزینه پرداخت در دسترس نباشد، قسمت گزینه پرداخت تنظیم نخواهد شد. |
parking_options | گزینه های پارکینگ ارائه شده توسط مکان. |
sub_destinations[] | فهرستی از مقصدهای فرعی مربوط به مکان. |
fuel_options | جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود. |
ev_charge_options | اطلاعات گزینه های شارژ ev. |
generative_summary | آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید. خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی. |
area_summary | آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید. خلاصه ای از منطقه ای که مکان در آن ایجاد شده است. |
utc_offset_minutes | تعداد دقیقههایی که منطقه زمانی این مکان در حال حاضر از UTC خارج شده است. این در دقیقه برای پشتیبانی از مناطق زمانی بیان میشود که با کسری از ساعت جبران میشوند، به عنوان مثال X ساعت و 15 دقیقه. |
user_rating_count | تعداد کل نظرات (با یا بدون متن) برای این مکان. |
takeout | مشخص میکند که آیا کسبوکار از بیرونبر پشتیبانی میکند یا خیر. |
delivery | مشخص می کند که آیا کسب و کار از تحویل پشتیبانی می کند یا خیر. |
dine_in | مشخص میکند که آیا کسبوکار از گزینههای صندلی داخلی یا خارجی پشتیبانی میکند. |
curbside_pickup | مشخص میکند که آیا کسبوکار از پیکاپ کناری پشتیبانی میکند یا خیر. |
reservable | مشخص می کند که آیا مکان از رزرو پشتیبانی می کند یا خیر. |
serves_breakfast | مشخص می کند که آیا در آن مکان صبحانه سرو می شود. |
serves_lunch | مشخص می کند که آیا در آن مکان ناهار سرو می شود یا خیر. |
serves_dinner | مشخص می کند که آیا در آن مکان شام سرو می شود. |
serves_beer | مشخص می کند که آیا در آن مکان آبجو سرو می شود. |
serves_wine | مشخص می کند که آیا در آن مکان شراب سرو می شود. |
serves_brunch | مشخص می کند که آیا در آن مکان برانچ سرو می شود. |
serves_vegetarian_food | مشخص می کند که آیا در آن مکان غذای گیاهی سرو می شود. |
outdoor_seating | مکان صندلی در فضای باز فراهم می کند. |
live_music | مکان موسیقی زنده را ارائه می دهد. |
menu_for_children | مکان دارای منوی کودکان است. |
serves_cocktails | محل سرو کوکتل است. |
serves_dessert | محل سرو دسر. |
serves_coffee | محل سرو قهوه است. |
good_for_children | مکان برای کودکان خوب است. |
allows_dogs | مکان به سگ ها اجازه می دهد. |
restroom | محل دارای سرویس بهداشتی |
good_for_groups | مکان گروه ها را در خود جای می دهد. |
good_for_watching_sports | مکانی برای تماشای ورزش مناسب است. |
accessibility_options | اطلاعاتی درباره گزینههای دسترسپذیری که یک مکان ارائه میدهد. |
گزینه های دسترسی
اطلاعاتی درباره گزینههای دسترسپذیری که یک مکان ارائه میدهد.
زمینه های | |
---|---|
wheelchair_accessible_parking | مکان دارای پارکینگ قابل دسترسی برای ویلچر است. |
wheelchair_accessible_entrance | اماکن دارای ورودی قابل دسترسی با ویلچر است. |
wheelchair_accessible_restroom | این مکان دارای سرویس بهداشتی قابل دسترسی برای ویلچر است. |
wheelchair_accessible_seating | مکان دارای صندلی های قابل دسترسی برای ویلچر است. |
Address Component
اجزای ساختاری که آدرس فرمت شده را تشکیل می دهند، اگر این اطلاعات در دسترس باشد.
زمینه های | |
---|---|
long_text | شرح متن کامل یا نام جزء آدرس. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است دارای نام طولانی "Australia" باشد. |
short_text | یک نام متنی مختصر برای جزء آدرس، در صورت وجود. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است نام کوتاه "AU" داشته باشد. |
types[] | آرایه ای که نوع(های) جزء آدرس را نشان می دهد. |
language_code | زبان مورد استفاده برای قالب بندی این مؤلفه ها، در نماد CLDR. |
خلاصه منطقه
آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.
خلاصه ای از منطقه ای که مکان در آن ایجاد شده است.
زمینه های | |
---|---|
content_blocks[] | بلوک های محتوایی که خلاصه منطقه را تشکیل می دهند. هر بلوک یک موضوع جداگانه در مورد منطقه دارد. |
انتساب
اطلاعاتی درباره ارائه دهندگان داده این مکان.
زمینه های | |
---|---|
provider | نام ارائهدهنده داده Place. |
provider_uri | URI به ارائهدهنده داده Place. |
وضعیت کسب و کار
وضعیت تجاری برای مکان
Enums | |
---|---|
BUSINESS_STATUS_UNSPECIFIED | مقدار پیش فرض. این مقدار استفاده نشده است. |
OPERATIONAL | تأسیسات عملیاتی است، لزوماً اکنون باز نیست. |
CLOSED_TEMPORARILY | موسسه به طور موقت تعطیل است. |
CLOSED_PERMANENTLY | موسسه برای همیشه تعطیل است. |
خلاصه تولیدی
آزمایشی: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید.
خلاصه ای از مکان ایجاد شده توسط هوش مصنوعی.
زمینه های | |
---|---|
overview | نمای کلی مکان. |
description | شرح دقیق مکان. |
references | مراجعی که برای تولید شرح خلاصه استفاده می شود. |
ساعات کار
اطلاعات مربوط به ساعت کاری محل
زمینه های | |
---|---|
periods[] | دوره هایی که این مکان در طول هفته باز است. دورهها به ترتیب زمانی هستند و از یکشنبه در منطقه زمانی مکانی-مکانی شروع میشوند. مقدار خالی (اما وجود ندارد) مکانی را نشان می دهد که هرگز باز نیست، به عنوان مثال به این دلیل که به طور موقت برای بازسازی بسته شده است. |
weekday_descriptions[] | رشتههای محلی که ساعات کار این مکان را توصیف میکنند، یک رشته برای هر روز هفته. اگر ساعت ها ناشناخته باشند یا نتوان آنها را به متن محلی تبدیل کرد خالی خواهد بود. مثال: "Sun: 18:00-06:00" |
secondary_hours_type | رشته ای که برای شناسایی نوع ساعات ثانویه استفاده می شود. |
special_days[] | اطلاعات ساختاریافته برای روزهای خاص که در دوره ای است که ساعات بازگردانده شده را پوشش می دهد. روزهای خاص روزهایی هستند که می توانند بر ساعات کاری یک مکان تأثیر بگذارند، مثلاً روز کریسمس. در صورت وجود ساعات استثنایی ، برای current_opening_hours و current_secondary_opening_hours تنظیم کنید. |
open_now | آیا این مکان در حال حاضر باز است؟ همیشه حضور داشته باشید مگر اینکه برای این ساعات کار فاقد داده های روزانه یا منطقه زمانی باشیم. |
دوره زمانی
دوره ای که مکان در وضعیت Open_Now باقی می ماند.
زمینه های | |
---|---|
open | زمانی که مکان باز می شود. |
close | زمانی که مکان بسته می شود. |
نقطه
تغییر وضعیت امتیاز.
زمینه های | |
---|---|
date | تاریخ در منطقه زمانی محلی برای مکان. |
truncated | آیا این نقطه پایانی کوتاه شده است یا نه. کوتاه شدن زمانی اتفاق می افتد که ساعات واقعی خارج از زمان است که ما مایل به بازگشت ساعت ها هستیم ، بنابراین ساعتهای برگشت به این مرزها را کوتاه می کنیم. این تضمین می کند که حداکثر 24 * 7 ساعت از نیمه شب روز درخواست بازگردانده می شود. |
day | یک روز از هفته ، به عنوان یک عدد صحیح در محدوده 0-6. 0 یکشنبه است ، 1 دوشنبه و غیره است. |
hour | ساعت در 2 رقم. محدوده از 00 تا 23. |
minute | دقیقه در 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 | تاریخ این روز خاص. |
پارکینگ
اطلاعات در مورد گزینه های پارکینگ برای مکان. یک پارکینگ می تواند بیش از یک گزینه را همزمان پشتیبانی کند.
زمینه های | |
---|---|
free_parking_lot | مکان پارکینگ های رایگان را ارائه می دهد. |
paid_parking_lot | پارکینگ های پولی را پیشنهاد می دهد. |
free_street_parking | Place پارکینگ خیابانی رایگان را ارائه می دهد. |
paid_street_parking | Place Production Parking Parking Parking. |
valet_parking | PLACE پارکینگ نوکر را ارائه می دهد. |
free_garage_parking | Place پارکینگ گاراژ رایگان را ارائه می دهد. |
paid_garage_parking | پارکینگ گاراژ پولی را پیشنهاد می دهد. |
گزینه های پرداخت
گزینه های پرداخت مکان را می پذیرد.
زمینه های | |
---|---|
accepts_credit_cards | مکان کارتهای اعتباری را به عنوان پرداخت می پذیرد. |
accepts_debit_cards | مکان کارت های بدهی را به عنوان پرداخت می پذیرد. |
accepts_cash_only | مکان فقط به عنوان پرداخت پول نقد را می پذیرد. مکان هایی با این ویژگی ممکن است هنوز روشهای پرداخت دیگری را بپذیرند. |
accepts_nfc | مکان پرداخت های NFC را می پذیرد. |
کد
کد به علاوه ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد جهانی تعریف یک 14MX14M (1/8000 درجه درجه) یا مستطیل کوچکتر و کد مرکب ، جایگزین پیشوند با یک مکان مرجع.
زمینه های | |
---|---|
global_code | کد جهانی (کامل) مکان ، مانند "9FWM33GV+HQ" ، نماینده 1/8000 در منطقه 1/8000 درجه (14 پوند در 14 متر). |
compound_code | کد مرکب Place مانند "33GV+HQ ، RAMBERG ، نروژ" ، حاوی پسوند کد جهانی و جایگزین کردن پیشوند با نام فرمت یک موجود مرجع. |
تعالی
نام منابع و شناسه زیر مقاصد مربوط به مکان را قرار دهید. به عنوان مثال ، پایانه های مختلف مقصد های مختلف یک فرودگاه هستند.
زمینه های | |
---|---|
name | نام منابع زیر مقصد. |
id | شناسه مکان از زیر مقصد. |
سطح قیمت
سطح قیمت مکان.
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[] | بررسی هایی که به عنوان مرجع عمل می کنند. |
places[] | لیست نام منابع مکانهای ارجاع شده. این نام را می توان در سایر API ها که نام منابع را می پذیرند استفاده شود. |
مرور
اطلاعات مربوط به بررسی یک مکان.
زمینه های | |
---|---|
name | مرجع به نمایندگی از این بررسی مکان که ممکن است برای جستجوی دوباره این مکان مورد استفاده قرار گیرد (همچنین نام "منبع" API نامیده می شود: |
relative_publish_time_description | رشته ای از زمان اخیر فرمت شده ، بیان زمان بررسی نسبت به زمان فعلی در فرم مناسب برای زبان و کشور. |
text | متن بومی شده بررسی. |
original_text | متن نقد و بررسی به زبان اصلی آن. |
rating | تعدادی بین 1.0 تا 5.0 ، که به آن تعداد ستاره ها نیز گفته می شود. |
author_attribution | نویسنده این بررسی |
publish_time | Timestamp برای بررسی. |
SearchNearByRequest
درخواست Proto برای جستجو در این نزدیکی کنید.
زمینه های | |
---|---|
language_code | جزئیات مکان در صورت وجود با زبان ترجیحی نمایش داده می شود. اگر کد زبان نامشخص یا ناشناخته باشد ، در صورت وجود چنین جزئیات ، می توانید جزئیات هر زبانی را برگردانید ، با اولویت انگلیسی. لیست فعلی زبانهای پشتیبانی شده: https://developers.google.com/maps/faq#languagesupport . |
region_code | کد کشور/منطقه یونیکد (CLDR) از مکانی که درخواست از آن می آید. این پارامتر برای نمایش جزئیات مکان ، مانند نام مکان خاص ، در صورت وجود استفاده می شود. این پارامتر می تواند بر اساس قانون قابل اجرا بر نتایج تأثیر بگذارد. برای اطلاعات بیشتر ، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید. توجه داشته باشید که کدهای منطقه 3 رقمی در حال حاضر پشتیبانی نمی شوند. |
included_types[] | شامل نوع مکان (به عنوان مثال ، "رستوران" یا "gas_station") از https://developers.google.com/maps/documentation/places/web-service/place-types . حداکثر 50 نوع از جدول A ممکن است مشخص شود. اگر انواع متناقض وجود داشته باشد ، IE یک نوع در هر دو مورد در هر دو مورد - types و ududed_types ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود. اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند. |
excluded_types[] | نوع مکان مستثنی (به عنوان مثال ، "رستوران" یا "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[] | شامل نوع مکان اصلی (به عنوان مثال "رستوران" یا "gas_station") از https://developers.google.com/maps/documentation/places/web-service/place-types . یک مکان فقط می تواند یک نوع اصلی واحد از جدول انواع پشتیبانی شده مرتبط با آن داشته باشد. حداکثر 50 نوع از جدول A ممکن است مشخص شود. اگر انواع اولیه متناقض وجود داشته باشد ، یعنی یک نوع در هر دو مورد شامل_پریپه ها و حذف شده_پریپه ها ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود. اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند. |
excluded_primary_types[] | از نوع مکان اصلی حذف شده (به عنوان مثال "رستوران" یا "GAS_STATION") از https://developers.google.com/maps/documentation/places/web-service/place-types . حداکثر 50 نوع از جدول A ممکن است مشخص شود. اگر انواع اولیه متناقض وجود داشته باشد ، یعنی یک نوع در هر دو مورد شامل_پریپه ها و حذف شده_پریپه ها ظاهر می شود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود. اگر یک نوع مکان با محدودیت های مختلف مشخص شود ، فقط مکانهایی که تمام محدودیت ها را برآورده می کنند ، بازگردانده می شوند. به عنوان مثال ، اگر ما {شامل_تایپ = ["رستوران"] را داشته باشیم ، ududed_primary_types = ["رستوران"]} ، مکان های برگشتی خدمات مرتبط با "رستوران" را ارائه می دهند اما در درجه اول به عنوان "رستوران" کار نمی کنند. |
max_result_count | حداکثر تعداد نتایج برای بازگشت. این باید بین 1 تا 20 (به طور پیش فرض) باشد. اگر عدد ناشناخته باشد ، به حد بالایی باز می گردد. اگر عدد بر روی منفی تنظیم شود یا از حد بالایی فراتر رود ، یک خطای نامعتبر_ارگومنت بازگردانده می شود. |
location_restriction | ضروری. منطقه برای جستجو. |
rank_preference | چگونه نتایج در پاسخ رتبه بندی می شود. |
محل کار
منطقه برای جستجو.
زمینه های | |
---|---|
| |
circle | دایره ای که توسط مرکز نقطه و شعاع تعریف شده است. |
پیشران
چگونه نتایج در پاسخ رتبه بندی می شود.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED | مقدار RankPreference تنظیم نشده است. به طور پیش فرض از درجه محبوبیت استفاده خواهد کرد. |
DISTANCE | نتایج را با فاصله از بین می برد. |
POPULARITY | نتایج را با محبوبیت رتبه بندی می کند. |
پاسخ searchnearbyresponse
پاسخ پروتئین برای جستجو در این نزدیکی.
زمینه های | |
---|---|
places[] | لیستی از مکانهایی که نیازهای کاربر را مانند انواع مکان ها ، تعداد مکان ها و محدودیت موقعیت مکانی خاص برآورده می کند. |
SearchTextrequest
درخواست proto برای searchText.
زمینه های | |
---|---|
text_query | ضروری. پرس و جو متن برای جستجوی متنی. |
language_code | جزئیات مکان در صورت وجود با زبان ترجیحی نمایش داده می شود. اگر کد زبان نامشخص یا ناشناخته باشد ، ممکن است جزئیات هر زبانی را برگردانید ، با ترجیح انگلیسی در صورت وجود چنین جزئیات. لیست فعلی زبانهای پشتیبانی شده: https://developers.google.com/maps/faq#languagesupport . |
region_code | کد کشور/منطقه یونیکد (CLDR) از مکانی که درخواست از آن می آید. این پارامتر برای نمایش جزئیات مکان ، مانند نام مکان خاص ، در صورت وجود استفاده می شود. این پارامتر می تواند بر اساس قانون قابل اجرا بر نتایج تأثیر بگذارد. برای اطلاعات بیشتر ، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید. توجه داشته باشید که کدهای منطقه 3 رقمی در حال حاضر پشتیبانی نمی شوند. |
rank_preference | چگونه نتایج در پاسخ رتبه بندی می شود. |
included_type | نوع مکان درخواست شده لیست کامل انواع پشتیبانی شده: https://developers.google.com/maps/documentation/places/web-service/place-types . فقط از یک نوع پشتیبانی می کند. |
open_now | برای محدود کردن جستجو به مکانهایی که در حال حاضر باز هستند استفاده می شود. حالت پیش فرض غلط است. |
min_rating | نتایج را فیلتر کنید که میانگین امتیاز کاربر آن کاملاً کمتر از این حد است. یک مقدار معتبر باید یک شناور بین 0 تا 5 (به طور گسترده) در 0.5 Cadence IE باشد [0 ، 0.5 ، 1.0 ، ... ، 5.0]. رتبه ورودی تا نزدیکترین 0.5 (سقف) دور خواهد شد. به عنوان مثال ، امتیاز 0.6 تمام نتایج را با امتیاز کمتر از 1.0 از بین می برد. |
max_result_count | deprecated: به جای آن از حداکثر تعداد نتایج در هر صفحه که می تواند برگردانده شود. اگر تعداد نتایج موجود از اگر هر دو |
page_size | اختیاری. حداکثر تعداد نتایج در هر صفحه که می تواند برگردانده شود. اگر تعداد نتایج موجود از اگر هر دو |
page_token | اختیاری. یک نشان صفحه ، از یک تماس قبلی TextSearch دریافت شده است. این کار را برای بازیابی صفحه بعدی ارائه دهید. هنگام پیگیری ، تمام پارامترهای غیر از |
price_levels[] | برای محدود کردن جستجو به مکانهایی که به عنوان سطح خاصی از قیمت مشخص شده اند ، استفاده می شود. کاربران می توانند ترکیبی از سطح قیمت را انتخاب کنند. به طور پیش فرض برای انتخاب تمام سطح قیمت. |
strict_type_filtering | مورد استفاده برای تنظیم فیلتر نوع سخت برای type. در صورت تنظیم صحیح ، فقط نتایج از همان نوع بازگردانده می شود. به طور پیش فرض به غلط. |
location_bias | منطقه برای جستجو. این مکان به عنوان یک تعصب عمل می کند و این بدان معناست که نتایج اطراف مکان ممکن است برگردانده شود. نمی توان همراه با مکان_ restriction تنظیم کرد. |
location_restriction | منطقه برای جستجو. این مکان به عنوان یک محدودیت عمل می کند و این بدان معنی است که نتایج خارج از مکان بازگردانده نمی شود. نمی توان همراه با مکان_بیا تنظیم کرد. |
ev_options | اختیاری. گزینه های EV قابل جستجو درخواست جستجوی مکان را تنظیم کنید. |
اگلها
گزینه های EV قابل جستجو درخواست جستجوی مکان.
زمینه های | |
---|---|
minimum_charging_rate_kw | اختیاری. حداقل نرخ شارژ مورد نیاز در کیلووات. مکانی با نرخ شارژ کمتر از نرخ مشخص شده فیلتر می شود. |
connector_types[] | اختیاری. لیست انواع اتصال دهنده EV. مکانی که از هیچ یک از انواع کانکتور ذکر شده پشتیبانی نمی کند ، فیلتر می شود. |
مکان یابی
منطقه برای جستجو. این مکان به عنوان یک تعصب عمل می کند و این بدان معناست که نتایج اطراف مکان ممکن است برگردانده شود.
زمینه های | |
---|---|
| |
rectangle | یک جعبه مستطیل تعریف شده توسط گوشه شمال شرقی و جنوب غربی. |
circle | دایره ای که توسط مرکز نقطه و شعاع تعریف شده است. |
محل کار
منطقه برای جستجو. این مکان به عنوان یک محدودیت عمل می کند و این بدان معنی است که نتایج خارج از مکان بازگردانده نمی شود.
زمینه های | |
---|---|
| |
rectangle | یک جعبه مستطیل تعریف شده توسط گوشه شمال شرقی و جنوب غربی. |
پیشران
چگونه نتایج در پاسخ رتبه بندی می شود.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED | برای یک پرس و جو طبقه بندی مانند "رستوران ها در شهر نیویورک" ، ارتباط پیش فرض است. برای نمایش داده های غیر گروهی مانند "Mountain View ، CA" توصیه می کنیم که RankPreference UNSET را ترک کنید. |
DISTANCE | نتایج را با فاصله از بین می برد. |
RELEVANCE | نتایج را با توجه به رتبه بندی می کند. ترتیب مرتب سازی شده توسط پشته رتبه بندی عادی. |
پاسخ
پاسخ پروتئین برای متن جستجو.
زمینه های | |
---|---|
places[] | لیستی از مکانهایی که معیارهای جستجوی متن کاربر را رعایت می کنند. |
contextual_contents[] | آزمایش: برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative مراجعه کنید. لیستی از مطالب متنی که در آن هر ورودی به مکان مربوطه در همان شاخص در قسمت مکان ها ارتباط دارد. محتویات مربوط به |
next_page_token | نشانه ای که می تواند به عنوان |