Package google.maps.locationselection.v1beta

شاخص

LocationSelectionBeta

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

یافتن Nearby Places

rpc FindNearbyPlaces( FindNearbyPlacesRequest ) returns ( FindNearbyPlacesResponse )

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

FindPickupPointsForLocation

rpc FindPickupPointsForLocation( FindPickupPointsForLocationRequest ) returns ( FindPickupPointsForLocationResponse )

نقاط وانت را برای یک مکان مشخص پیدا کنید.

FindPickupPointsForPlace

rpc FindPickupPointsForPlace( FindPickupPointsForPlaceRequest ) returns ( FindPickupPointsForPlaceResponse )

نقاط وانت را برای یک مکان مشخص پیدا کنید.

آدرس

آدرس یک مکان

فیلدها
formatted_address

FormattedAddress

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

address_components[]

AddressComponent

لیستی از اجزای آدرس

Address Component

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

فیلدها
component_text

string

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

component_text_short_form

string

فرم کوتاه متن جزء. مثال‌ها عبارتند از «CA» برای «کالیفرنیا» و «US» برای «ایالات متحده».

types[]

string

انواع این مؤلفه که بخشی از آدرس را توصیف می کند. برای لیستی از انواع پشتیبانی شده، به https://developers.google.com/places/web-service/supported_types#table2 مراجعه کنید

مرکب

ترکیب مرتبط با مکان.

فیلدها
type

CompoundType

نوع ترکیب.

geometry

Geometry

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

entrances[]

Entrance

فهرست ورودی های مرتبط با محوطه.

CompoundTypeEnums

انواع ترکیبات

CompoundType

ارزش نوع مرکب.

Enums
COMPOUND_TYPE_UNSPECIFIED نوع ترکیب ناشناخته
SECTION بخش مرکب. https://support.google.com/mapskb/answer/7054299
BUILDING ساختمان مرکب. https://support.google.com/mapskb/answer/7013011
GROUNDS زمین های مرکب https://support.google.com/mapskb/answer/7046859

ورودی

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

فیلدها
location

LatLng

محل ورودی.

FindNearbyPlacesRequest

پیام درخواست مکان های نزدیک را پیدا کنید.

فیلدها
localization_preferences

LocalizationPreferences

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

search_location

LatLng

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

max_results

int32

مورد نیاز. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد.

wifi_access_points[]

WiFiAccessPoint

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

FindNearbyPlacesResponse

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

فیلدها
place_results[]

PlaceResult

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

FindPickupPointsForLocationRequest

پیام درخواست FindPickupPointsForLocation.

فیلدها
localization_preferences

LocalizationPreferences

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

search_location

LatLng

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

order_by

PickupPointOrder

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

destination

LatLng

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

max_results

int32

مورد نیاز. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد.

travel_modes[]

TravelMode

مورد نیاز. فقط نقاط وانتی که حداقل یکی از حالت‌های سفر مشخص شده را اجازه می‌دهند بازگردانده می‌شوند. حالت های سفر پشتیبانی شده: DRIVING و TWO_WHEELER. حداقل یک حالت باید مشخص شود.

compute_walking_eta

bool

اگر درست باشد، ETA پیاده‌روی از محل جستجو تا نقطه دریافت محاسبه می‌شود.

compute_driving_eta

bool

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

wifi_access_points[]

WiFiAccessPoint

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

FindPickupPointsForLocationResponse

نقاط دریافت پیام پاسخ موقعیت مکانی را پیدا کنید.

فیلدها
place_pickup_point_results[]

PlacePickupPointResult

نقاط دریافت نزدیک با شناسه مکان مرتبط. نتایج در این لیست بر اساس معیارهای ارائه شده در درخواست مرتب شده اند. ممکن است تعداد نتایج در "place_picup_point_results" از تعداد نتایج در "place_results" بیشتر باشد.

place_results[]

PlaceResult

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

FindPickupPointsFor PlaceRequest

پیام درخواست FindPickupPointsForPlace.

فیلدها
place_id

string

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

localization_preferences

LocalizationPreferences

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

search_location

LatLng

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

order_by

PickupPointOrder

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

destination

LatLng

مکان مقصد مورد نظر مشتری تنظیم اگر درخواست نقاط تحویل توسط ETA مقصد سفارش داده شود.

max_results

int32

مورد نیاز. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد.

travel_modes[]

TravelMode

مورد نیاز. فقط نقاط وانتی که حداقل یکی از حالت‌های سفر مشخص شده را اجازه می‌دهند بازگردانده می‌شوند. حالت های سفر پشتیبانی شده: DRIVING و TWO_WHEELER. حداقل یک حالت باید مشخص شود.

compute_walking_eta

bool

اگر درست باشد، ETA پیاده‌روی از محل جستجو تا نقطه دریافت محاسبه می‌شود.

compute_driving_eta

bool

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

FindPickupPointsForPlaceResponse

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

فیلدها
pickup_point_results[]

PickupPointResult

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

place_result

PlaceResult

مکان مرتبط با شناسه مکان داده شده در درخواست.

آدرس فرمت شده

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

فیلدها
lines[]

string

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

هندسه

هندسه یک مکان

فیلدها
location

LatLng

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

viewport

Viewport

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

display_boundary

Struct

با استفاده از قالب GeoJSON Polygon یک چند ضلعی را مشخص می کند

تنظیمات محلی سازی

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

فیلدها
language_code

string

مورد نیاز. برچسب زبان BCP-47 برای بومی سازی متون استفاده می شود. نمونه‌هایی از برچسب‌های زبان عبارتند از: "en-US"، "hi-IN"، "fr-CA"، و غیره.

region_code

string

مورد نیاز. کد کشور/منطقه یونیکد (CLDR) مکانی که درخواست از آن می‌آید، مانند "US" و "419".

برای اطلاعات بیشتر، http://www.unicode.org/reports/tr35/#unicode_region_subtag را ببینید.

Pickup Point

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

فیلدها
id

string

شناسه منحصر به فرد برای نقطه تحویل. باید حضور داشته باشد.

display_name

string

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

address

Address

آدرس محل وانت.

description

string

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

location

LatLng

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

PickupPointOrderEnums

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

PickupPointOrder

ارزش سفارش نقطه وانت.

Enums
PICKUP_POINT_ORDER_UNSPECIFIED سفارش نقطه تحویل مشخص نشده است. پیش‌فرض DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION ترتیب صعودی فاصله خط مستقیم از محل جستجو تا نقطه تحویل برگشتی.
WALKING_ETA_FROM_SEARCH_LOCATION ترتیب صعودی بر اساس زمان راه رفتن مصرف کننده از محل جستجو تا نقطه تحویل.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION ترتیب صعودی با رانندگی ETA از نقطه پیکاپ به مقصد مصرف کننده. این حالت فقط زمانی قابل استفاده است که مقصدی تنظیم شده باشد و compute_driving_eta درست باشد. هنگامی که چندین حالت travel_mode در درخواست ارائه می شود، سفارش بر اساس اولین حالت travel_mode در درخواست است.

PickupPoint Result

جزئیات درباره نتیجه جستجوی نقطه تحویل.

فیلدها
pickup_point

PickupPoint

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

distance_meters

float

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

travel_details[]

TravelDetail

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

مکان

جزئیات در مورد یک مکان

فیلدها
place_id

string

شناسه مکان محل. شناسه مکان متنی است که به طور منحصر به فرد مکان را مشخص می کند. https://developers.google.com/places/web-service/place-id

display_name

string

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

language_code

string

کد زبان فیلدهای متنی مرتبط با مکان. مثلاً «نام» و «آدرس».

address

Address

آدرس محل.

geometry

Geometry

هندسه مکان.

types[]

string

مجموعه ای از برچسب های نوع برای این نتیجه. مثلاً «سیاسی» و «محلی». https://developers.google.com/places/web-service/supported_types

associated_compounds[]

Compound

ترکیبات مرتبط با مکان.

PlacePickupPointResult

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

فیلدها
pickup_point_result

PickupPointResult

جزئیات در مورد نقطه وانت باید حضور داشته باشد.

associated_place_id

string

شناسه مکان مکان مرتبط

مکان نتیجه

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

فیلدها
place

Place

جزئیات در مورد یک مکان

distance_meters

float

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

TrafficRestrictionEnums

انواع محدودیت ترافیک برای یک مکان

محدودیت ترافیک

ارزش محدودیت ترافیکی

Enums
TRAFFIC_RESTRICTION_UNSPECIFIED محدودیت نامشخص نیست.
NO_RESTRICTION هیچ محدودیت ترافیکی اعمال نمی شود.
OTHER_RESTRICTION برخی از محدودیت‌های ترافیکی ممکن است اعمال شوند، مانند جاده خصوصی یا هزینه‌ای برای دسترسی به مکان مرتبط.

جزئیات سفر

جزئیات مربوط به سفر.

فیلدها
travel_mode

TravelMode

حالت سفر که تحت آن ETA محاسبه می شود.

estimated_arrival_time

Timestamp

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

traffic_restriction

TrafficRestriction

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

TravelModeEnums

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

حالت سفر

ارزش حالت سفر

Enums
TRAVEL_MODE_UNSPECIFIED حالت سفر مشخص نشده است.
WALKING پیاده روی، برای عابران پیاده استفاده می شود.
DRIVING رانندگی، برای اتومبیل های سواری استفاده می شود.
TWO_WHEELER موتور دو چرخ (مانند موتور سیکلت یا موتور سیکلت).

WiFiAccessPoint

اطلاعات نقطه دسترسی WiFi

فیلدها
mac_address

int64

آدرس MAC نقطه دسترسی.

strength_dbm

sint32

قدرت سیگنال نقطه دسترسی، بر حسب dBm.