Package google.maps.places.v1

شاخص

مکان ها

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

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

rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia( GetPhotoMediaRequest ) returns ( PhotoMedia )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace( GetPlaceRequest ) returns ( Place )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform
جستجو در نزدیکی

rpc SearchNearby( SearchNearbyRequest ) returns ( SearchNearbyResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText( SearchTextRequest ) returns ( SearchTextResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

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

فیلدها
landmarks[]

Landmark

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

areas[]

Area

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

منطقه

اطلاعات منطقه و ارتباط منطقه با مکان مورد نظر.

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

فیلدها
name

string

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

place_id

string

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

display_name

LocalizedText

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

containment

Containment

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

مهار

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

Enums
CONTAINMENT_UNSPECIFIED مهار نامشخص است.
WITHIN محل مورد نظر در منطقه منطقه، نزدیک به مرکز است.
OUTSKIRTS محل مورد نظر در منطقه منطقه، نزدیک به لبه است.
NEAR مکان مورد نظر خارج از منطقه است، اما نزدیک است.

نقطه عطف

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

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

فیلدها
name

string

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

place_id

string

شناسه مکان دیدنی

display_name

LocalizedText

نام نمایشی نقطه عطف

types[]

string

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

spatial_relationship

SpatialRelationship

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

straight_line_distance_meters

float

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

travel_distance_meters

float

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

رابطه فضایی

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

Enums
NEAR این رابطه پیش‌فرض زمانی است که هیچ چیز خاص‌تری در زیر اعمال نمی‌شود.
WITHIN این نقطه عطف دارای هندسه فضایی است و هدف در محدوده آن است.
BESIDE هدف مستقیماً در مجاورت نقطه عطف قرار دارد.
ACROSS_THE_ROAD هدف دقیقاً در مقابل نقطه عطفی در طرف دیگر جاده قرار دارد.
DOWN_THE_ROAD در همان مسیری که نقطه عطف است، اما نه در کنار یا آنطرف.
AROUND_THE_CORNER نه در همان مسیر با نقطه عطف، بلکه یک پیچ دورتر.
BEHIND نزدیک به ساختار نقطه عطفی اما دورتر از ورودی های خیابان آن.

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

اطلاعات مربوط به نویسنده داده های 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) ، یا فقط (regions) یا فقط (cities) . یک مکان تنها در صورتی برگردانده می شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 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 است.
  • مطمئن شوید که برای هر جلسه جدید یک نشانه جلسه منحصر به فرد ارسال می کنید. استفاده از یک نشانه برای بیش از یک جلسه باعث می شود که هر درخواست به صورت جداگانه صورتحساب شود.
include_pure_service_area_businesses

bool

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

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

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

فیلدها
content

LocalizedText

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

referenced_places[]

string

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

محتوای متنی

آزمایشی: برای جزئیات بیشتر به 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 پریز دیواری نامشخص
EV_CONNECTOR_TYPE_NACS سیستم شارژ آمریکای شمالی (NACS)، استاندارد شده به عنوان SAE J3400.

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

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

فیلدها
fuel_prices[]

FuelPrice

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

قیمت سوخت

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

فیلدها
type

FuelType

نوع سوخت.

price

Money

قیمت سوخت.

update_time

Timestamp

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

نوع سوخت

انواع سوخت.

Enums
FUEL_TYPE_UNSPECIFIED نوع سوخت نامشخص
DIESEL سوخت دیزل.
DIESEL_PLUS گازوئیل به اضافه سوخت.
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 گاز مایع.
E80 E 80.
E85 E 85.
E100 E 100.
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

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

flag_content_uri

string

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

google_maps_uri

string

پیوندی برای نمایش عکس در Google Maps.

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 ببینید. اگر نوع اصلی مکان، نوع پشتیبانی‌شده نباشد، ممکن است نوع اولیه وجود نداشته باشد. وقتی یک نوع اولیه وجود دارد، همیشه یکی از انواع در فیلد 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

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

postal_address

PostalAddress

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

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

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

time_zone

TimeZone

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

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

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

containing_places[]

ContainingPlace

فهرست مکان هایی که مکان فعلی در آنها قرار دارد.

address_descriptor

AddressDescriptor

توصیف کننده آدرس مکان. توصیفگرهای آدرس شامل اطلاعات اضافی است که به توصیف یک مکان با استفاده از نشانه‌ها و مناطق کمک می‌کند. پوشش منطقه ای توصیفگر آدرس را در https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage ببینید.

price_range

PriceRange

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

review_summary

ReviewSummary

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

ev_charge_amenity_summary

EvChargeAmenitySummary

خلاصه امکانات در نزدیکی ایستگاه شارژ EV.

neighborhood_summary

NeighborhoodSummary

خلاصه ای از نقاط دیدنی در نزدیکی مکان.

consumer_alert

ConsumerAlert

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

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

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

pure_service_area_business

bool

نشان می دهد که آیا این مکان یک کسب و کار منطقه خدماتی خالص است یا خیر. کسب و کار منطقه خدمات خالص کسب و کاری است که مستقیماً از مشتریان بازدید می کند یا به آنها تحویل می دهد اما به مشتریان در آدرس کسب و کار آنها خدمات ارائه نمی دهد. به عنوان مثال، مشاغلی مانند خدمات نظافتی یا لوله کش. این مشاغل ممکن است آدرس فیزیکی یا مکان در Google Maps نداشته باشند.

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

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

فیلدها
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.

انتساب

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

فیلدها
provider

string

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

provider_uri

string

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

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

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

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

ConsumerAlert

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

فیلدها
overview

string

نمای کلی پیام هشدار مصرف کننده

details

Details

جزئیات پیام هشدار مصرف کننده.ƒ

language_code

string

کد زبان پیام هشدار مصرف کننده. این یک کد زبان BCP 47 است.

جزئیات

جزئیات پیام هشدار مصرف کننده.

فیلدها
title

string

عنوان برای نمایش همراه با توضیحات.

description

string

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

حاوی مکان

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

فیلدها
name

string

نام منبع مکانی که این مکان در آن قرار دارد.

id

string

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

EvChargeAmenitySummary

خلاصه امکانات در نزدیکی ایستگاه شارژ EV. این فقط برای مکان هایی با نوع electric_vehicle_charging_station اعمال می شود. فیلد overview تضمین می شود در حالی که فیلدهای دیگر اختیاری هستند.

فیلدها
overview

ContentBlock

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

coffee

ContentBlock

خلاصه ای از گزینه های قهوه در نزدیکی.

restaurant

ContentBlock

خلاصه ای از رستوران های اطراف

store

ContentBlock

خلاصه ای از فروشگاه های اطراف

flag_content_uri

string

پیوندی که در آن کاربران می توانند مشکلی را با خلاصه علامت گذاری کنند.

disclosure_text

LocalizedText

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

خلاصه تولیدی

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

فیلدها
overview

LocalizedText

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

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

خلاصه محله

خلاصه ای از نقاط دیدنی در نزدیکی مکان.

فیلدها
overview

ContentBlock

خلاصه ای از محله.

description

ContentBlock

شرح مفصلی از محله.

flag_content_uri

string

پیوندی که در آن کاربران می توانند مشکلی را با خلاصه علامت گذاری کنند.

disclosure_text

LocalizedText

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

ساعات کار

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

فیلدها
periods[]

Period

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

روز شروع periods ثابت نیست و نباید یکشنبه فرض شود. API روز شروع را بر اساس عوامل مختلفی تعیین می کند. به عنوان مثال، برای یک تجارت 24 ساعته، اولین دوره ممکن است از روز درخواست شروع شود. برای سایر مشاغل، ممکن است اولین روز هفته باشد که باز هستند.

توجه: ترتیب آرایه های periods مستقل از ترتیب آرایه weekday_descriptions است. تصور نکنید که آنها در همان روز شروع می شوند.

weekday_descriptions[]

string

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

توجه: ترتیب روزها و شروع هفته بر اساس منطقه (زبان و منطقه) تعیین می شود. ترتیب آرایه های periods مستقل از ترتیب آرایه weekday_descriptions است. تصور نکنید که آنها در همان روز شروع می شوند.

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

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

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

next_open_time

Timestamp

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

next_close_time

Timestamp

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

open_now

bool

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

دوره

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

فیلدها
open

Point

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

close

Point

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

نقطه

نقاط تغییر وضعیت

فیلدها
date

Date

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

truncated

bool

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

day

int32

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

hour

int32

ساعت در قالب 24 ساعته. محدوده از 0 تا 23.

minute

int32

دقیقه محدوده از 0 تا 59.

SecondaryHoursType

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

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

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

paid_street_parking

bool

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

valet_parking

bool

مکان دارای پارکینگ خدمتکار است.

free_garage_parking

bool

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

paid_garage_parking

bool

مکان دارای پارکینگ گاراژ پولی است.

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

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

فیلدها
accepts_credit_cards

bool

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

accepts_debit_cards

bool

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

accepts_cash_only

bool

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

accepts_nfc

bool

Place پرداخت‌های 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، Norway"، حاوی پسوند کد جهانی و جایگزینی پیشوند با نام قالب بندی شده یک نهاد مرجع.

خلاصه مرور

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

فیلدها
text

LocalizedText

خلاصه نظرات کاربران

flag_content_uri

string

پیوندی که در آن کاربران می توانند مشکلی را با خلاصه علامت گذاری کنند.

disclosure_text

LocalizedText

پیام افشای هوش مصنوعی "خلاصه شده با جمینی" (و انواع محلی آن). در صورت وجود، این به زبان مشخص شده در درخواست خواهد بود.

reviews_uri

string

پیوندی برای نمایش نظرات این مکان در Google Maps.

مقصد فرعی

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

فیلدها
name

string

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

id

string

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

پلی لاین

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

فیلدها
فیلد اتحادیه polyline_type . نوع پلی لاین را کپسوله می کند. خروجی API را به صورت پیش‌فرض روی encoded_polyline می‌فرستد. polyline_type می تواند تنها یکی از موارد زیر باشد:
encoded_polyline

string

یک چند خط کدگذاری شده که توسط Routes API به طور پیش فرض برگردانده شده است. ابزارهای رمزگذار و رمزگشا را ببینید.

سطح قیمت

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

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

محدوده قیمت

محدوده قیمت مرتبط با یک مکان. end_price می‌تواند تنظیم نشود، که محدوده‌ای را بدون کران بالا نشان می‌دهد (مثلاً "بیش از 100 دلار").

فیلدها
start_price

Money

پایان پایین محدوده قیمت (شامل). قیمت باید در این مقدار یا بالاتر باشد.

end_price

Money

پایان بالای محدوده قیمت (انحصاری). قیمت باید کمتر از این مقدار باشد.

بررسی کنید

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

فیلدها
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

مهر زمانی برای بررسی

flag_content_uri

string

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

google_maps_uri

string

پیوندی برای نمایش نظر در Google Maps.

visit_date

Date

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

RouteModifiers

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

فیلدها
avoid_tolls

bool

اختیاری. وقتی روی true تنظیم شود، در صورت معقول بودن از جاده‌های عوارضی اجتناب می‌کند و به مسیرهایی که شامل جاده‌های عوارضی نیستند، ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid_highways

bool

اختیاری. وقتی روی true تنظیم شود، از بزرگراه‌هایی که معقول باشد اجتناب می‌کند و به مسیرهایی که شامل بزرگراه نیستند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid_ferries

bool

اختیاری. وقتی روی true تنظیم شود، در صورت معقول بودن از کشتی‌ها اجتناب می‌کند و به مسیرهایی که شامل کشتی نیستند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid_indoor

bool

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

پارامترهای مسیریابی

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

فیلدها
origin

LatLng

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

travel_mode

TravelMode

اختیاری. حالت سفر

route_modifiers

RouteModifiers

اختیاری. اصلاح کننده های مسیر

routing_preference

RoutingPreference

اختیاری. نحوه محاسبه خلاصه های مسیریابی را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اولویت مسیریابی آگاه از ترافیک فقط برای DRIVE یا TWO_WHEELER travelMode در دسترس است.

RoutingPreference

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

Enums
ROUTING_PREFERENCE_UNSPECIFIED هیچ اولویت مسیریابی مشخص نشده است. پیش‌فرض TRAFFIC_UNAWARE است.
TRAFFIC_UNAWARE مسیرها را بدون در نظر گرفتن شرایط ترافیکی زنده محاسبه می کند. مناسب زمانی که شرایط ترافیک مهم نیست یا قابل اجرا نیست. استفاده از این مقدار کمترین تاخیر را ایجاد می کند. توجه: برای TravelMode DRIVE و TWO_WHEELER ، مسیر و مدت زمان انتخاب شده بر اساس شبکه جاده و میانگین شرایط ترافیک مستقل از زمان است، نه شرایط فعلی جاده. در نتیجه، مسیرها ممکن است شامل جاده هایی باشد که به طور موقت بسته هستند. نتایج برای یک درخواست معین ممکن است در طول زمان به دلیل تغییرات در شبکه جاده‌ها، میانگین به‌روز شده شرایط ترافیکی و ماهیت توزیع‌شده خدمات متفاوت باشد. نتایج همچنین ممکن است بین مسیرهای تقریباً معادل در هر زمان یا فرکانس متفاوت باشد.
TRAFFIC_AWARE مسیرها را با در نظر گرفتن شرایط ترافیکی زنده محاسبه می کند. برخلاف TRAFFIC_AWARE_OPTIMAL ، برخی بهینه‌سازی‌ها برای کاهش قابل توجه تأخیر اعمال می‌شوند.
TRAFFIC_AWARE_OPTIMAL مسیرها را با در نظر گرفتن شرایط ترافیکی زنده، بدون اعمال اکثر بهینه‌سازی‌های عملکرد، محاسبه می‌کند. استفاده از این مقدار بیشترین تاخیر را ایجاد می کند.

Routing Summary

مدت و فاصله از مبدأ مسیریابی تا مکانی در پاسخ، و یک راه دوم از آن مکان تا مقصد، در صورت درخواست. توجه: اضافه کردن routingSummaries در ماسک فیلد بدون درج پارامتر routingParameters.origin یا پارامتر searchAlongRouteParameters.polyline.encodedPolyline در درخواست باعث ایجاد خطا می‌شود.

فیلدها
legs[]

Leg

پاهای سفر.

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

directions_uri

string

پیوندی برای نشان دادن مسیرها در Google Maps با استفاده از نقاط راه از خلاصه مسیریابی داده شده. مسیر تولید شده توسط این پیوند با مسیری که برای تولید خلاصه مسیریابی استفاده می‌شود، تضمین نمی‌شود. پیوند از اطلاعات ارائه شده در درخواست، از فیلدهایی از جمله routingParameters و searchAlongRouteParameters در صورت لزوم، برای ایجاد پیوند جهت استفاده می کند.

پا

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

فیلدها
duration

Duration

زمان لازم برای تکمیل این مرحله از سفر.

distance_meters

int32

مسافت این مرحله از سفر.

SearchNearbyRequest

درخواست پروتو برای Search Nearby.

فیلدها
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

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

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

اگر انواع متضاد وجود داشته باشد، یعنی یک نوع در هر دو نوع include_types و excluded_types ظاهر شود، یک خطای INVALID_ARGUMENT برگردانده می شود.

اگر یک نوع مکان با محدودیت‌های چندگانه مشخص شده باشد، تنها مکان‌هایی برگردانده می‌شوند که همه محدودیت‌ها را برآورده کنند. برای مثال، اگر {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} داشته باشیم، مکان‌های برگشتی خدمات مرتبط با "رستوران" را ارائه می‌کنند اما عمدتاً به عنوان "رستوران" عمل نمی‌کنند.

excluded_types[]

string

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

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

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

اگر انواع متضاد وجود داشته باشد، یعنی یک نوع در هر دو نوع include_types و excluded_types ظاهر شود، یک خطای INVALID_ARGUMENT برگردانده می شود.

اگر یک نوع مکان با محدودیت‌های چندگانه مشخص شده باشد، تنها مکان‌هایی برگردانده می‌شوند که همه محدودیت‌ها را برآورده کنند. برای مثال، اگر {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} داشته باشیم، مکان‌های برگشتی خدمات مرتبط با "رستوران" را ارائه می‌کنند اما عمدتاً به عنوان "رستوران" عمل نمی‌کنند.

included_primary_types[]

string

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

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

اگر انواع اصلی متناقض وجود داشته باشد، یعنی یک نوع در هر دو نوع include_primary_types و excluded_primary_types ظاهر شود، یک خطای INVALID_ARGUMENT برگردانده می شود.

اگر یک نوع مکان با محدودیت‌های چندگانه مشخص شده باشد، تنها مکان‌هایی برگردانده می‌شوند که همه محدودیت‌ها را برآورده کنند. برای مثال، اگر {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} داشته باشیم، مکان‌های برگشتی خدمات مرتبط با "رستوران" را ارائه می‌کنند اما عمدتاً به عنوان "رستوران" عمل نمی‌کنند.

excluded_primary_types[]

string

نوع مکان اصلی (مثلاً "رستوران" یا "پمپ_گاز") از https://developers.google.com/maps/documentation/places/web-service/place-types مستثنی شده است.

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

اگر انواع اصلی متناقض وجود داشته باشد، یعنی یک نوع در هر دو نوع include_primary_types و excluded_primary_types ظاهر شود، یک خطای INVALID_ARGUMENT برگردانده می شود.

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

max_result_count

int32

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

location_restriction

LocationRestriction

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

rank_preference

RankPreference

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

routing_parameters

RoutingParameters

اختیاری. پارامترهایی که بر روی مسیریابی به نتایج جستجو تأثیر می گذارد.

محل کار

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

فیلدها

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

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

circle

Circle

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

پیشران

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

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

پاسخ searchnearbyresponse

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

فیلدها
places[]

Place

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

routing_summaries[]

RoutingSummary

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

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 قابل جستجو درخواست جستجوی مکان را تنظیم کنید.

routing_parameters

RoutingParameters

اختیاری. پارامترهای اضافی برای مسیریابی به نتایج.

search_along_route_parameters

SearchAlongRouteParameters

اختیاری. پارامترهای اضافی برای جستجو در طول مسیر.

include_pure_service_area_businesses

bool

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

اگلها

گزینه های 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 نتایج را با توجه به رتبه بندی می کند. ترتیب مرتب سازی شده توسط پشته رتبه بندی عادی.

searchalongrouteparameters

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

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

فیلدها
polyline

Polyline

مورد نیاز. پلی خط مسیر.

پاسخ

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

فیلدها
places[]

Place

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

routing_summaries[]

RoutingSummary

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

contextual_contents[]

ContextualContent

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

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

next_page_token

string

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

search_uri

string

پیوندی به کاربر اجازه می دهد تا با همان پرس و جو متنی که در درخواست در Google Maps مشخص شده است ، جستجو کند.

حرکت

گزینه های حالت سفر. این گزینه ها به آنچه مسیرهای API ارائه می دهد ، نقشه می کند.

Enums
TRAVEL_MODE_UNSPECIFIED هیچ حالت سفر مشخص نشده است. پیش فرض برای DRIVE .
DRIVE سفر با ماشین مسافر.
BICYCLE سفر با دوچرخه. با search_along_route_parameters پشتیبانی نمی شود.
WALK سفر با راه رفتن با search_along_route_parameters پشتیبانی نمی شود.
TWO_WHEELER دو وسیله نقلیه چرخدار از انواع مختلف مانند اسکوتر و موتور سیکلت. توجه داشته باشید که این از حالت سفر BICYCLE که حمل و نقل با نیروی انسانی را در بر می گیرد ، متمایز است. با search_along_route_parameters پشتیبانی نمی شود. فقط در کشورهایی که در کشورها و مناطقی که برای وسایل نقلیه دو چرخ پشتیبانی می شوند ، پشتیبانی می شود.