Package google.maps.areainsights.v1

شاخص

AreaInsights

تعریف سرویس برای Places Insights API.

ComputeInsights

rpc ComputeInsights( ComputeInsightsRequest ) returns ( ComputeInsightsResponse )

محاسبه RPC Insights

این روش به شما امکان می‌دهد با استفاده از فیلترهای مختلفی مانند: منطقه، نوع مکان، وضعیت عملیاتی، سطح قیمت و رتبه‌بندی، بینش‌هایی در مورد مناطق بازیابی کنید. در حال حاضر اطلاعات آماری «شمارش» و «مکان‌ها» پشتیبانی می‌شوند. با بینش‌های «شمارش» می‌توانید به سؤالاتی مانند «چند رستوران در کالیفرنیا واقع شده‌اند که عملیاتی هستند، ارزان هستند و میانگین رتبه‌بندی حداقل 4 ستاره دارند» (برای جزئیات بیشتر به فهرست insight مراجعه کنید). با اطلاعات آماری «مکان‌ها»، می‌توانید تعیین کنید کدام مکان‌ها با فیلتر درخواستی مطابقت دارند. سپس مشتریان می توانند از نام منابع مکان برای دریافت جزئیات بیشتر در مورد هر مکان جداگانه با استفاده از Places API استفاده کنند.

محدوده مجوز

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

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

ComputeInsightsRequest

درخواست ComputeInsights RPC.

فیلدها
insights[]

Insight

مورد نیاز. بینش برای محاسبه در حال حاضر فقط INSIGHT_COUNT و INSIGHT_PLACES پشتیبانی می‌شوند.

filter

Filter

مورد نیاز. فیلتر بینش

ComputeInsightsResponse

پاسخ برای ComputeInsights RPC.

فیلدها
place_insights[]

PlaceInsight

نتیجه برای Insights.INSIGHT_PLACES.

count

int64

نتیجه برای Insights.INSIGHT_COUNT.

فیلتر کنید

فیلترها برای ComputeInsights RPC.

فیلدها
location_filter

LocationFilter

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

type_filter

TypeFilter

مورد نیاز. فیلترهای نوع مکان

operating_status[]

OperatingStatus

اختیاری. نتایج را به مکان هایی که وضعیت عملیاتی آنها در این لیست گنجانده شده است محدود می کند. اگر وضعیت_operation تنظیم نشده باشد، OPERATING_STATUS_OPERATIONAL به عنوان پیش فرض استفاده می شود.

price_levels[]

PriceLevel

اختیاری. نتایج را به مکان‌هایی محدود می‌کند که سطح قیمت آن‌ها در این فهرست گنجانده شده است. اگر price_level تنظیم نشده باشد، تمام سطوح قیمت در نتایج گنجانده شده است.

rating_filter

RatingFilter

اختیاری. نتایج را به مکان‌هایی محدود می‌کند که میانگین رتبه‌بندی کاربران آن‌ها در محدوده تعیین‌شده توسط rating_filter است. اگر rating_filter تنظیم نشده باشد، همه رتبه‌بندی‌ها در نتیجه گنجانده می‌شود.

بینش

بینش های پشتیبانی شده

Enums
INSIGHT_UNSPECIFIED مشخص نشده است.
INSIGHT_COUNT

بینش را بشمار

وقتی این بینش مشخص شد، ComputeInsights تعداد مکان‌هایی را که با معیارهای فیلتر مشخص شده مطابقت دارند، برمی‌گرداند. 

For example if the request is:
ComputeInsightsRequest {
  insights: INSIGHT_COUNT
  filter {
    location_filter {region: <PlaceId of state of CA>}
    type_filter {included_types: "restaurant"}
    operating_status: OPERATING_STATUS_OPERATIONAL
    price_levels: PRICE_LEVEL_FREE
    price_levels: PRICE_LEVEL_INEXPENSIVE
    min_rating: 4.0
  }
}

The method will return the count of restaurants in California that are
operational, with price level free or inexpensive and have an average
rating of at least 4 starts.

Example response:
ComputeInsightsResponse {
  count: <number of places>
}
INSIGHT_PLACES

مکان ها را برگردانید

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

For example if the request is:
ComputeInsightsRequest {
  insights: INSIGHT_PLACES
  filter {
    location_filter {region: <PlaceId of state of CA>}
    type_filter {included_types: "restaurant"}
    operating_status: OPERATING_STATUS_OPERATIONAL
    price_levels: PRICE_LEVEL_FREE
    price_levels: PRICE_LEVEL_INEXPENSIVE
    min_rating: 4.0
  }
}

The method will return list of places of restaurants in
California that are operational, with price level free or inexpensive and
have an average rating of at least 4 stars.

Example response:
ComputeInsightsResponse {
  place_insights { place: "places/ABC" }
  place_insights { place: "places/PQR" }
  place_insights { place: "places/XYZ" }
}

محل فیلتر

فیلترهای مکان

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

فیلدها
area میدان اتحادیه یکی از موارد زیر باید مشخص شود. area می تواند تنها یکی از موارد زیر باشد:
circle

Circle

مساحت به صورت دایره

region

Region

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

custom_area

CustomArea

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

دایره

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

فیلدها
radius

int32

اختیاری. شعاع دایره بر حسب متر

center صحرایی اتحادیه مرکز دایره. center فقط می تواند یکی از موارد زیر باشد:
lat_lng

LatLng

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

place

string

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

Custom Area

منطقه سفارشی

فیلدها
polygon

Polygon

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

چند ضلعی

یک چند ضلعی با مجموعه ای از مختصات متصل در یک دنباله مرتب شده در خلاف جهت عقربه های ساعت نشان داده می شود. مختصات یک حلقه بسته را تشکیل می دهند و یک منطقه پر شده را تعریف می کنند. مختصات اول و آخر معادل هستند و باید مقادیر یکسانی داشته باشند. این قالب یک نسخه ساده شده از چند ضلعی های GeoJSON است (ما فقط از یک حلقه بیرونی در خلاف جهت عقربه های ساعت پشتیبانی می کنیم).

فیلدها
coordinates[]

LatLng

اختیاری. مختصاتی که چند ضلعی را تعریف می کنند.

منطقه

منطقه یک مرز جغرافیایی است مانند: شهرها، کد پستی، شهرستان ها، ایالت ها و غیره.

فیلدها
region میدان اتحادیه یک منطقه جغرافیایی را تعریف می کند. فقط یک نوع منطقه (مثلا مکان) را می توان در یک زمان مشخص کرد. region می تواند تنها یکی از موارد زیر باشد:
place

string

شناسه منحصر به فرد یک منطقه جغرافیایی خاص.

وضعیت عملیاتی

وضعیت عملیاتی محل.

Enums
OPERATING_STATUS_UNSPECIFIED مشخص نشده است.
OPERATING_STATUS_OPERATIONAL این مکان در ساعات مشخصی فعال بوده و باز است.
OPERATING_STATUS_PERMANENTLY_CLOSED مکان دیگر در کار نیست.
OPERATING_STATUS_TEMPORARILY_CLOSED مکان به طور موقت بسته است و انتظار می رود در آینده بازگشایی شود.

PlaceInsight

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

فیلدها
place

string

شناسه منحصر به فرد مکان. این نام منبع را می توان برای بازیابی جزئیات مکان با استفاده از Places API استفاده کرد.

سطح قیمت

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

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

فیلتر رتبه بندی

فیلترهای میانگین امتیاز کاربران

فیلدها
min_rating

float

اختیاری. نتایج را به مکان‌هایی محدود می‌کند که میانگین رتبه‌بندی کاربران آن‌ها بیشتر یا مساوی min_rating است. مقادیر باید بین 1.0 و 5.0 باشد.

max_rating

float

اختیاری. نتایج را به مکان‌هایی محدود می‌کند که میانگین رتبه‌بندی کاربران آنها به شدت کمتر یا برابر با max_rating است. مقادیر باید بین 1.0 و 5.0 باشد.

TypeFilter

فیلترهای نوع مکان

فقط انواع مکان از جدول a پشتیبانی می شود.

یک مکان فقط می‌تواند یک نوع اصلی مرتبط با آن داشته باشد. به عنوان مثال، نوع اولیه ممکن است "رستوران_مکزیکی" یا "استیک_خانه" باشد. برای فیلتر کردن نتایج روی نوع اصلی مکان، از include_primary_types و excluded_primary_types استفاده کنید.

یک مکان همچنین می تواند چندین مقدار نوع مرتبط با آن داشته باشد. به عنوان مثال یک رستوران ممکن است انواع زیر را داشته باشد: "رستوران_دریایی"، "رستوران"، "غذا"، "نقطه_علاقه"، "تأسیس". از include_types و excluded_types برای فیلتر کردن نتایج در لیست انواع مرتبط با یک مکان استفاده کنید.

اگر جستجویی با محدودیت‌های چندگانه مشخص شده باشد، فقط مکان‌هایی که همه محدودیت‌ها را برآورده می‌کنند، برگردانده می‌شوند. برای مثال، اگر {"Included_types": ["restaurant"]، "excluded_primary_types": ["steak_house"]} را مشخص کنید، مکان‌های برگشتی خدمات مرتبط با "رستوران" را ارائه می‌کنند اما عمدتاً به عنوان "steak_house" عمل نمی‌کنند.

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

یکی از include_types یا include_primary_types باید تنظیم شود.

فیلدها
included_types[]

string

اختیاری. شامل انواع مکان.

excluded_types[]

string

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

included_primary_types[]

string

اختیاری. شامل انواع مکان اصلی.

excluded_primary_types[]

string

اختیاری. انواع مکان اصلی مستثنی شده است.