فهرست مطالب
-
LocationSelectionBeta
(رابط) -
Address
(پیام) -
AddressComponent
(پیام) -
Compound
(پیام) -
CompoundTypeEnums
(پیام) -
CompoundTypeEnums.CompoundType
(enum) -
Entrance
(پیام) -
FindNearbyPlacesRequest
(پیام) -
FindNearbyPlacesResponse
(پیام) -
FindPickupPointsForLocationRequest
(پیام) -
FindPickupPointsForLocationResponse
(پیام) -
FindPickupPointsForPlaceRequest
(پیام) -
FindPickupPointsForPlaceResponse
(پیام) -
FormattedAddress
(پیام) -
Geometry
(پیام) -
LocalizationPreferences
(پیام) -
PickupPoint
(پیام) -
PickupPointOrderEnums
(پیام) -
PickupPointOrderEnums.PickupPointOrder
(enum) -
PickupPointResult
(پیام) -
Place
(پیام) -
PlacePickupPointResult
(پیام) -
PlaceResult
(پیام) -
TrafficRestrictionEnums
(پیام) -
TrafficRestrictionEnums.TrafficRestriction
(enum) -
TravelDetail
(پیام) -
TravelModeEnums
(پیام) -
TravelModeEnums.TravelMode
(enum) -
WiFiAccessPoint
(پیام)
LocationSelectionBeta
خدمات دریافت مکان های نزدیک و نقاط تحویل و تحویل مرتبط.
یافتن Nearby Places |
---|
مکان های نزدیک را برای یک مکان مشخص پیدا کنید. |
FindPickupPointsForLocation |
---|
نقاط وانت را برای یک مکان مشخص پیدا کنید. |
FindPickupPointsForPlace |
---|
نقاط وانت را برای یک مکان مشخص پیدا کنید. |
نشانی
آدرس یک مکان
زمینه های | |
---|---|
formatted_address | آدرسی کامل و قابل خواندن برای انسان برای این مکان. |
address_components[] | لیستی از اجزای آدرس |
Address Component
یک جزء آدرس که بخشی از آدرس را توصیف می کند.
زمینه های | |
---|---|
component_text | نام این جزء که بخشی از آدرس را توصیف می کند. به عنوان مثال می توان به "کالیفرنیا"، "Amphitheatre Parkway" اشاره کرد. |
component_text_short_form | فرم کوتاه متن جزء. مثالها عبارتند از «CA» برای «کالیفرنیا» و «US» برای «ایالات متحده». |
types[] | انواع این مؤلفه که بخشی از آدرس را توصیف می کند. برای لیستی از انواع پشتیبانی شده، به https://developers.google.com/places/web-service/supported_types#table2 مراجعه کنید |
ترکیب
ترکیب مرتبط با مکان.
زمینه های | |
---|---|
type | نوع ترکیب. |
geometry | هندسه مرتبط با ترکیب. |
entrances[] | فهرست ورودی های مرتبط با محوطه. |
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 | محل ورودی. |
FindNearbyPlacesRequest
پیام درخواست مکان های نزدیک را پیدا کنید.
زمینه های | |
---|---|
localization_preferences | ضروری. ترجیحات مورد استفاده برای بومی سازی متون در پاسخ، به عنوان مثال، نام و آدرس. |
search_location | ضروری. مکانی که باید مکان هایی را پیدا کرد. |
max_results | ضروری. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد. |
wifi_access_points[] | نقاط دسترسی WiFi در اطراف محل درخواست. برای ارائه نتایج جستجو با کیفیت بالاتر استفاده می شود. |
FindNearbyPlacesResponse
مکان های نزدیک را برای یک پیام پاسخ مکان مشخص پیدا کنید.
زمینه های | |
---|---|
place_results[] | لیست مرتب از مکان های پیدا شده اگر جایی در اطراف محل درخواست یافت نشد ممکن است خالی باشد. سفارش بر اساس ترکیبی از احتمال و فاصله است. |
FindPickupPointsForLocationRequest
پیام درخواست FindPickupPointsForLocation.
زمینه های | |
---|---|
localization_preferences | ضروری. ترجیحات مورد استفاده برای بومی سازی متون در پاسخ، به عنوان مثال، نام و آدرس. |
search_location | ضروری. مکان مورد استفاده برای جستجوی نقاط وانت و محاسبه فواصل و ETA تا نقاط وانت. |
order_by | ضروری. سفارش برای استفاده هنگام برگرداندن نتایج. |
destination | مکان مقصد مورد نظر مشتری هنگام درخواست نقاط تحویل مرتب شده بر اساس ETA مقصد، تنظیم کنید. |
max_results | ضروری. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد. |
travel_modes[] | ضروری. فقط نقاط وانتی که حداقل یکی از حالتهای سفر مشخص شده را اجازه میدهند بازگردانده میشوند. حالت های سفر پشتیبانی شده: DRIVING و TWO_WHEELER. حداقل یک حالت باید مشخص شود. |
compute_walking_eta | اگر درست باشد، ETA پیادهروی از محل جستجو تا نقطه دریافت محاسبه میشود. |
compute_driving_eta | اگر درست باشد و مقصد مشخص شده باشد، ETA رانندگی از نقطه تحویل به مقصد محاسبه می شود. |
wifi_access_points[] | نقاط دسترسی WiFi در اطراف مکان جستجو. برای ارائه نتایج جستجو با کیفیت بالاتر استفاده می شود. |
FindPickupPointsForLocationResponse
نقاط دریافت پیام پاسخ موقعیت مکانی را پیدا کنید.
زمینه های | |
---|---|
place_pickup_point_results[] | نقاط دریافت نزدیک با شناسه مکان مرتبط. نتایج در این لیست بر اساس معیارهای ارائه شده در درخواست مرتب شده اند. ممکن است تعداد نتایج در "place_picup_point_results" از تعداد نتایج در "place_results" بیشتر باشد. |
place_results[] | جزئیات مربوط به مکانهای مرتبط با نقاط وانت اطراف. نتایج در این لیست مرتب نیستند. |
FindPickupPointsFor PlaceRequest
پیام درخواست FindPickupPointsForPlace.
زمینه های | |
---|---|
place_id | ضروری. شناسه مکان مکانی که برای آن امتیاز وانت درخواست شده است. |
localization_preferences | ضروری. ترجیحات مورد استفاده برای بومی سازی متون در پاسخ، به عنوان مثال، نام و آدرس. |
search_location | مکان مورد استفاده برای جستجوی نقاط وانت و محاسبه فواصل و ETA تا نقاط وانت. اگر تنظیم نشده باشد، از مکان مکان مرتبط با شناسه مکان داده شده استفاده می شود. |
order_by | ضروری. سفارش برای استفاده هنگام برگرداندن نتایج. |
destination | مکان مقصد مورد نظر مشتری تنظیم اگر درخواست نقاط تحویل توسط ETA مقصد سفارش داده شود. |
max_results | ضروری. حداکثر تعداد نتایجی که باید برگردانده شوند. باید بزرگتر از 0 باشد. |
travel_modes[] | ضروری. فقط نقاط وانتی که حداقل یکی از حالتهای سفر مشخص شده را اجازه میدهند بازگردانده میشوند. حالت های سفر پشتیبانی شده: DRIVING و TWO_WHEELER. حداقل یک حالت باید مشخص شود. |
compute_walking_eta | اگر درست باشد، ETA پیادهروی از محل جستجو تا نقطه دریافت محاسبه میشود. |
compute_driving_eta | اگر درست باشد و مقصد مشخص شده باشد، ETA رانندگی از نقطه تحویل به مقصد محاسبه می شود. |
FindPickupPointsForPlaceResponse
نقاط تحویل را برای پیام پاسخ مکان پیدا کنید.
زمینه های | |
---|---|
pickup_point_results[] | نقاط دریافتی که با معیارهای درخواست مطابقت دارند. اگر هیچ نقطه تحویلی با معیارهای درخواست مطابقت نداشته باشد، ممکن است خالی باشد. |
place_result | مکان مرتبط با شناسه مکان داده شده در درخواست. |
آدرس فرمت شده
یک آدرس کامل و قابل خواندن توسط انسان برای موجودیت حاوی این پیام.
زمینه های | |
---|---|
lines[] | خطوط متنی که آدرس را توصیف می کند. حداقل یک خط باید وجود داشته باشد. |
هندسه
هندسه یک مکان
زمینه های | |
---|---|
location | نقطه مرکزی موجودیت حاوی این پیام. |
viewport | یک نمای مناسب برای نمایش مکان در یک نقشه با اندازه متوسط. |
display_boundary | با استفاده از قالب GeoJSON Polygon یک چند ضلعی را مشخص می کند |
تنظیمات محلی سازی
یک آدرس کامل و قابل خواندن توسط انسان برای موجودیت حاوی این پیام.
زمینه های | |
---|---|
language_code | ضروری. برچسب زبان BCP-47 برای بومی سازی متون استفاده می شود. نمونههایی از برچسبهای زبان عبارتند از: "en-US"، "hi-IN"، "fr-CA"، و غیره. |
region_code | ضروری. کد کشور/منطقه یونیکد (CLDR) مکانی که درخواست از آن میآید، مانند "US" و "419". برای اطلاعات بیشتر، http://www.unicode.org/reports/tr35/#unicode_region_subtag را ببینید. |
Pickup Point
جزئیات مربوط به یک نقطه تحویل یا خروج.
زمینه های | |
---|---|
id | شناسه منحصر به فرد برای نقطه تحویل. باید حضور داشته باشد. |
display_name | نام کوتاه و قابل خواندن برای انسان نقطه پیکاپ. بومی سازی بر اساس اولویت ارائه شده در درخواست. |
address | آدرس محل وانت. |
description | شرح طولانی تر از نقطه تحویل، که ممکن است شامل نحوه رسیدن به مکان باشد. |
location | محل قرارگیری نقطه وانت؛ جایی که یک سوار یا گیرنده با راننده ملاقات می کند. باید حضور داشته باشد. |
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 | نقطه تحویل واقعی که با درخواست مطابقت دارد. |
distance_meters | فاصله خط مستقیم از این نقطه دریافت تا مکان جستجوی مشخص شده در درخواست. |
travel_details[] | جزئیات مربوط به سفر به و از این نقطه تحویل برای هر حالت سفر درخواستی. |
محل
جزئیات در مورد یک مکان
زمینه های | |
---|---|
place_id | شناسه مکان محل. شناسه مکان متنی است که به طور منحصر به فرد مکان را مشخص می کند. https://developers.google.com/places/web-service/place-id |
display_name | نام مکان محلی شده است. بومی سازی بر اساس اولویت ارائه شده در درخواست. |
language_code | کد زبان فیلدهای متنی مرتبط با مکان. مثلاً «نام» و «آدرس». |
address | آدرس محل. |
geometry | هندسه مکان. |
types[] | مجموعه ای از برچسب های نوع برای این نتیجه. مثلاً «سیاسی» و «محلی». https://developers.google.com/places/web-service/supported_types |
associated_compounds[] | ترکیبات مرتبط با مکان. |
PlacePickupPointResult
نقاط تحویل با شناسه مکان مرتبط.
زمینه های | |
---|---|
pickup_point_result | جزئیات در مورد نقطه وانت باید حضور داشته باشد. |
associated_place_id | شناسه مکان مکان مرتبط |
مکان نتیجه
جزئیات درباره نتیجه جستجوی مکان.
زمینه های | |
---|---|
place | جزئیات در مورد یک مکان |
distance_meters | فاصله خط مستقیم از محل جستجو تا هندسه مکان یا مرکز. |
TrafficRestrictionEnums
انواع محدودیت ترافیک برای یک مکان
محدودیت ترافیک
ارزش محدودیت ترافیکی
Enums | |
---|---|
TRAFFIC_RESTRICTION_UNSPECIFIED | محدودیت نامشخص نیست. |
NO_RESTRICTION | هیچ محدودیت ترافیکی اعمال نمی شود. |
OTHER_RESTRICTION | برخی از محدودیتهای ترافیکی ممکن است اعمال شوند، مانند جاده خصوصی یا هزینهای برای دسترسی به مکان مرتبط. |
جزئیات سفر
جزئیات مربوط به سفر.
زمینه های | |
---|---|
travel_mode | حالت سفر که تحت آن ETA محاسبه می شود. |
estimated_arrival_time | زمان تخمینی رسیدن. زمانی که compute_walking_eta در درخواست تنظیم شده باشد، زمان پیادهروی از محل جستجو تا مکان نقطه دریافت محاسبه میشود. زمانی که compute_driving_eta و مقصد در درخواست تنظیم شده باشد، ETA رانندگی از محل نقطه دریافت تا مقصد برای هر حالت سفر درخواستی غیرعابر پیاده محاسبه میشود. ETA رانندگی با ترافیک محاسبه می شود و مشمول محدودیت های تراکم نیست. |
traffic_restriction | محدودیتی که برای حالت سفر اعمال می شود. |
TravelModeEnums
فهرست حالتهای سفر در دسترس برای سفر به یک مکان.
حالت سفر
ارزش حالت سفر
Enums | |
---|---|
TRAVEL_MODE_UNSPECIFIED | حالت سفر مشخص نشده است. |
WALKING | پیاده روی، برای عابران پیاده استفاده می شود. |
DRIVING | رانندگی، برای اتومبیل های سواری استفاده می شود. |
TWO_WHEELER | موتور دو چرخ (مانند موتور سیکلت یا موتور سیکلت). |
WiFiAccessPoint
اطلاعات نقطه دسترسی WiFi
زمینه های | |
---|---|
mac_address | آدرس MAC نقطه دسترسی. |
strength_dbm | قدرت سیگنال نقطه دسترسی، بر حسب dBm. |