Package google.maps.places.v1

شاخص

مکان ها

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

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

rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse )

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

محدوده مجوز

به محدوده 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

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

فیلدها
topic

string

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

content

LocalizedText

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

references

References

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

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

محتوای متنی

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

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

فیلدها
reviews[]

Review

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

photos[]

Photo

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

justifications[]

Justification

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

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

توجیه

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

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

فیلدها

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

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

review_justification

ReviewJustification

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

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributes توجیه

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

فیلدها
takeout

bool

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

delivery

bool

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

dine_in

bool

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

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

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

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

فیلدها
highlighted_text

HighlightedText

review

Review

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

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

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

فیلدها
text

string

highlighted_text_ranges[]

HighlightedTextRange

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

HighlightedTextRange

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

فیلدها
start_index

int32

end_index

int32

EVChargeOptions

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

فیلدها
connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

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

ConnectorAggregation

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

فیلدها
type

EVConnectorType

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

max_charge_rate_kw

double

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

count

int32

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

availability_last_update_time

Timestamp

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

available_count

int32

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

out_of_service_count

int32

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

EVConnectorType

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

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

primary_type_display_name

LocalizedText

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

national_phone_number

string

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

international_phone_number

string

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

formatted_address

string

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

short_formatted_address

string

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

address_components[]

AddressComponent

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

plus_code

PlusCode

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

location

LatLng

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

viewport

Viewport

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

rating

double

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

google_maps_uri

string

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

website_uri

string

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

reviews[]

Review

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

regular_opening_hours

OpeningHours

ساعات کار منظم. توجه داشته باشید که اگر مکانی همیشه باز باشد (24 ساعت)، قسمت close تنظیم نخواهد شد. مشتری‌ها می‌توانند همیشه باز (24 ساعت) به‌عنوان یک دوره [open][google.maps.places.v1.Place.OpeningHours.Period.open] متکی باشند که شامل [day][Point.day] با مقدار 0 ، [hour][Point.hour] با مقدار 0 و [minute][Point.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

شامل خلاصه ای از مکان است. خلاصه ای از یک مرور کلی متنی تشکیل شده است ، و همچنین شامل کد زبان برای این موارد در صورت لزوم است. متن خلاصه باید به عنوان IS ارائه شود و قابل تغییر یا تغییر نیست.

payment_options

PaymentOptions

گزینه های پرداخت مکان را می پذیرد. اگر داده های گزینه پرداخت در دسترس نباشد ، قسمت گزینه پرداخت غیرقانونی خواهد بود.

parking_options

ParkingOptions

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

sub_destinations[]

SubDestination

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

fuel_options

FuelOptions

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

ev_charge_options

EVChargeOptions

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

generative_summary

GenerativeSummary

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

خلاصه ای از مکان.

area_summary

AreaSummary

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

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

containing_places[]

ContainingPlace

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

address_descriptor

AddressDescriptor

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

price_range

PriceRange

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

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

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

wheelchair_accessible_entrance

bool

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

wheelchair_accessible_restroom

bool

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

wheelchair_accessible_seating

bool

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

مؤلفه

در صورت وجود این اطلاعات ، مؤلفه های ساختاری که آدرس فرمت شده را تشکیل می دهند.

فیلدها
long_text

string

توضیحات کامل متن یا نام مؤلفه آدرس. به عنوان مثال ، یک مؤلفه آدرس برای کشور استرالیا ممکن است یک نام طولانی از "استرالیا" داشته باشد.

short_text

string

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

types[]

string

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

language_code

string

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

منطقه

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

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

فیلدها
content_blocks[]

ContentBlock

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

flag_content_uri

string

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

انتساب

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

فیلدها
provider

string

نام ارائه دهنده داده مکان.

provider_uri

string

URI به ارائه دهنده داده های مکان.

تجارت

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

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

حاوی محل

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

فیلدها
name

string

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

id

string

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

وابسته به نسل

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

خلاصه ای از مکان.

فیلدها
overview

LocalizedText

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

overview_flag_content_uri

string

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

description

LocalizedText

توضیحات مفصل مکان.

description_flag_content_uri

string

پیوندی که کاربران می توانند با خلاصه توضیحات مشکل را پرچم گذاری کنند.

references

References

منابع مورد استفاده برای تولید توضیحات خلاصه.

افتتاحیه

اطلاعات مربوط به ساعت تجارت محل.

فیلدها
periods[]

Period

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

weekday_descriptions[]

string

رشته های بومی شده که ساعات کار این مکان را توصیف می کند ، یک رشته برای هر روز از هفته. اگر ساعت ها ناشناخته باشند یا به متن بومی شده تبدیل نشوند ، خالی خواهد بود. مثال: "خورشید: 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 متغیر است.

نوع ثانویه

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

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

روز ویژه

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

فیلدها
date

Date

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

پارکینگ

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

فیلدها
free_parking_lot

bool

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

paid_parking_lot

bool

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

free_street_parking

bool

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

paid_street_parking

bool

Place Production Parking Parking Parking.

valet_parking

bool

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

free_garage_parking

bool

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

paid_garage_parking

bool

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

پرداخت

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

فیلدها
accepts_credit_cards

bool

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

accepts_debit_cards

bool

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

accepts_cash_only

bool

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

accepts_nfc

bool

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

کد

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

فیلدها
global_code

string

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

compound_code

string

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

تعالی

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

فیلدها
name

string

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

id

string

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

پلی لاین

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

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

string

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

پری

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

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

قیمت گذاری

دامنه قیمت مرتبط با یک مکان. end_price می تواند غیرقانونی باشد ، که نشان دهنده دامنه ای بدون محدودیت فوقانی است (به عنوان مثال "بیش از 100 دلار").

فیلدها
start_price

Money

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

end_price

Money

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

مراجع

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

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

فیلدها
reviews[]

Review

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

places[]

string

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

بررسی کنید

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

فیلدها
name

string

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

relative_publish_time_description

string

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

text

LocalizedText

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

original_text

LocalizedText

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

rating

double

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

author_attribution

AuthorAttribution

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

publish_time

Timestamp

Timestamp برای بررسی.

flag_content_uri

string

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

google_maps_uri

string

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

رویه سازان

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

فیلدها
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

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

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

فیلدها
origin

LatLng

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

travel_mode

TravelMode

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

route_modifiers

RouteModifiers

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

routing_preference

RoutingPreference

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

پیشروی مسیریابی

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

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

مسیریابی

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

فیلدها
legs[]

Leg

پاهای سفر.

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

directions_uri

string

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

پا

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

فیلدها
duration

Duration

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

distance_meters

int32

فاصله این پای سفر.

SearchNearByRequest

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

فیلدها
language_code

string

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

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

region_code

string

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

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

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

included_types[]

string

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

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

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

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

excluded_types[]

string

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

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

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

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

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

included_primary_types[]

string

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

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

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

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

excluded_primary_types[]

string

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

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

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

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

max_result_count

int32

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

location_restriction

LocationRestriction

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

rank_preference

RankPreference

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

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 پشتیبانی نمی شود. فقط در کشورهایی که در کشورها و مناطقی که برای وسایل نقلیه دو چرخ پشتیبانی می شوند ، پشتیبانی می شود.