Package google.maps.geocode.v4alpha

فهرست

سرویس مقصد

سرویسی برای بازیابی مقصدها.

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

جستجومقصدها

rpc SearchDestinations( SearchDestinationsRequest ) returns ( SearchDestinationsResponse )

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

دامنه‌های مجوز

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

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

خدمات ژئوکد

سرویسی برای انجام ژئوکدینگ.

کد جغرافیاییآدرس

rpc GeocodeAddress( GeocodeAddressRequest ) returns ( GeocodeAddressResponse )

این متد یک geocode آدرس را انجام می‌دهد که یک آدرس را به LatLng نگاشت می‌کند. همچنین اطلاعات ساختاریافته‌ای در مورد آدرس ارائه می‌دهد.

دامنه‌های مجوز

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
کد جغرافیاییموقعیت مکانی

rpc GeocodeLocation( GeocodeLocationRequest ) returns ( GeocodeLocationResponse )

این متد یک geocode مکانی را انجام می‌دهد که یک LatLng را به یک آدرس نگاشت می‌کند. همچنین اطلاعات ساختاریافته‌ای در مورد آدرس ارائه می‌دهد.

دامنه‌های مجوز

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
مکان جغرافیایی

rpc GeocodePlace( GeocodePlaceRequest ) returns ( GeocodeResult )

این روش با استفاده از شناسه مکان، جستجوی کد جغرافیایی را انجام می‌دهد.

دامنه‌های مجوز

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

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

مقصد

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

فیلدها
primary

PlaceView

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

containing_places[]

PlaceView

مکان‌های کم‌اهمیت‌تری که مکان اصلی در آن‌ها قرار دارد. برای مثال، مجتمع آپارتمانی که این ساختمان را در بر می‌گیرد.

sub_destinations[]

PlaceView

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

نکته: در مقایسه با SubDestination که توسط Places API برگردانده می‌شود، این لیست از زیرمقصدها جامع‌تر است و هر زیرمقصد شامل اطلاعات بیشتری است.

landmarks[]

Landmark

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

entrances[]

Entrance

ورودی‌های این مقصد.

navigation_points[]

NavigationPoint

نقاط ناوبری برای این مقصد.

arrival_summary

Destination.ArrivalSummary

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

خلاصه ورود

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

فیلدها
text

LocalizedText

خلاصه‌ای از تجربه ورود به مقصد.

flag_content_url

string

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

disclosure_text

LocalizedText

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

ورودی

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

فیلدها
location

LatLng

محل قرارگیری ورودی.

tags[]

Entrance.Tag

فهرستی از برچسب‌ها که ورودی را توصیف می‌کنند.

place

string

ساختاری که این ورودی به صورت فیزیکی روی آن قرار دارد، با فرمت places/{place_id} .

برچسب

ویژگی‌هایی که یک ورودی را توصیف می‌کنند.

انوم‌ها
TAG_UNSPECIFIED استفاده نشده.
PREFERRED

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

برای مثال، اگر مکان اصلی یک رستوران در یک مرکز خرید باشد، ورودی‌های «ترجیحی» ورودی‌هایی خواهند بود که احتمالاً به خود رستوران منتهی می‌شوند، در حالی که سایر ورودی‌های برگشتی، ورودی‌های دیگری برای ساختمان، مانند ورودی‌های رستوران‌های دیگر در مرکز خرید، خواهند بود.

اگر مکان اصلی خود یک ساختمان باشد، ورودی‌های PREFERRED ورودی‌هایی خواهند بود که به قسمت «اصلی» ساختمان منتهی می‌شوند. برای مثال، در یک مرکز خرید، ورودی‌های PREFERRED ، ورودی‌هایی هستند که امکان دسترسی به فضای اصلی سرسرا را فراهم می‌کنند، اما اگر یک ورودی فقط دسترسی به یک فروشگاه در کنار ساختمان را فراهم کند، ورودی PREFERRED نخواهد بود.

توجه: یک ورودی PREFERRED ممکن است دسترسی به مکان اصلی را فراهم نکند و یک ورودی غیر PREFERRED ممکن است دسترسی به مکان اصلی را فراهم کند.

کد جغرافیاییآدرسدرخواست

درخواست پیام برای GeocodeService.GeocodeAddress.

فیلدها
location_bias

GeocodeAddressRequest.LocationBias

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

language_code

string

اختیاری. زبانی که نتایج باید با آن برگردانده شوند.

region_code

string

اختیاری. کد منطقه. کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. این پارامتر بر اساس قانون مربوطه بر نتایج تأثیر می‌گذارد. این پارامتر همچنین بر نتایج حاصل از سرویس تأثیر می‌گذارد، اما آنها را به طور کامل محدود نمی‌کند.

فیلد union address_input . آدرس address_input فقط می‌تواند یکی از موارد زیر باشد:
address_query

string

آدرس بدون ساختار به geocode.

address

PostalAddress

آدرس ساختاریافته برای ژئوکد کردن در قالب آدرس پستی.

موقعیت مکانی

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

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

Viewport

یک کادر مستطیلی که توسط گوشه‌های شمال شرقی و جنوب غربی تعریف شده است. rectangle.high() باید نقطه شمال شرقی نمای مستطیل باشد. rectangle.low() باید نقطه جنوب غربی نمای مستطیل باشد. rectangle.low().latitude() نمی‌تواند بزرگتر از rectangle.high().latitude() باشد. این منجر به یک محدوده عرض جغرافیایی خالی می‌شود. نمای مستطیلی نمی‌تواند عریض‌تر از ۱۸۰ درجه باشد.

کد جغرافیاییآدرسپاسخ

پیام پاسخ برای GeocodeService.GeocodeAddress .

فیلدها
results[]

GeocodeResult

نتیجه کدگذاری جغرافیایی.

کد جغرافیاییدرخواست موقعیت مکانی

درخواست پیام برای GeocodeService.GeocodeLocation.

فیلدها
language_code

string

اختیاری. زبانی که نتایج باید با آن برگردانده شوند.

region_code

string

اختیاری. کد منطقه. کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. این پارامتر بر اساس قانون مربوطه بر نتایج تأثیر می‌گذارد.

types[]

string

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

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

granularity[]

GeocodeResult.Granularity

اختیاری. فیلتری از یک یا چند enum با جزئیات مکانی.

فیلد union location_input . مکانی که باید location_input قرار گیرد، فقط می‌تواند یکی از موارد زیر باشد:
location_query

string

مکان در قالب رشته "lat,lng". برای مثال، "64.7611872,-18.4705364".

location

LatLng

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

کد جغرافیاییموقعیتپاسخ

پیام پاسخ برای GeocodeService.GeocodeLocation .

فیلدها
results[]

GeocodeResult

نتیجه کدگذاری جغرافیایی.

plus_code

PlusCode

کد بعلاوه‌ی مکان مورد نظر در درخواست.

درخواست مکان جغرافیایی

درخواست پیام برای GeocodeService.GeocodePlace.

فیلدها
place

string

الزامی. شناسه مکان برای کد جغرافیایی در قالب places/{place}.

language_code

string

اختیاری. زبانی که نتایج باید با آن برگردانده شوند.

region_code

string

اختیاری. کد منطقه. کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. این پارامتر بر اساس قانون مربوطه بر نتایج تأثیر می‌گذارد.

نتیجه کد جغرافیایی

نتیجه‌ی کد جغرافیایی شامل اطلاعات جغرافیایی در مورد یک مکان است.

فیلدها
place

string

شناسه مکان کاملاً واجد شرایط برای این نتیجه. در قالب "//places.googleapis.com/places/{placeID}". برای جزئیات بیشتر به https://developers.google.com/maps/documentation/places/web-service/place-id مراجعه کنید.

place_id

string

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

location

LatLng

طول این آدرس.

granularity

GeocodeResult.Granularity

جزئیات مکان.

viewport

Viewport

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

bounds

Viewport

یک کادر محدودکننده برای آدرس.

formatted_address

string

آدرس با فرمت تک خطی.

postal_address

PostalAddress

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

address_components[]

GeocodeResult.AddressComponent

اجزای تکراری برای هر سطح محلی.

postal_code_localities[]

LocalizedText

فهرست کامل محل‌های ذکر شده در کد پستی.

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

types[]

string

مجموعه‌ای از برچسب‌های نوع برای این نتیجه. به عنوان مثال، "political" و "administrative_area".

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

plus_code

PlusCode

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

کامپوننت آدرس

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

فیلدها
long_text

string

توضیحات کامل متنی یا نام کامپوننت آدرس. برای مثال، یک کامپوننت آدرس برای کشور استرالیا ممکن است نام طولانی "Australia" داشته باشد.

short_text

string

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

types[]

string

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

برای جزئیات بیشتر به https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types مراجعه کنید.

language_code

string

زبانی که برای قالب‌بندی این مؤلفه‌ها استفاده می‌شود، با نمادگذاری CLDR.

دانه‌بندی

جزئیات مکان.

انوم‌ها
GRANULARITY_UNSPECIFIED استفاده نکنید.
ROOFTOP مکان غیر درون‌یابی شده‌ی یک قطعه زمین واقعی که با آدرس تطبیق داده شده مطابقت دارد.
RANGE_INTERPOLATED از طیف وسیعی از شماره خیابان‌ها درون‌یابی شده است. برای مثال، اگر بدانیم که بخشی از خیابان آمفی‌تئاتر شامل شماره‌های ۱۶۰۰ تا ۱۶۹۹ است، آنگاه ۱۶۵۰ ممکن است در میانه راه بین نقاط انتهایی آن قرار گیرد.
GEOMETRIC_CENTER مرکز هندسی یک عارضه که داده‌های چندضلعی آن را داریم.
APPROXIMATE هر چیز دیگری.

نقطه عطف

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

فیلدها
relational_description

LocalizedText

توضیحی خوانا برای انسان از چگونگی ارتباط مقصد با مکان دیدنی. برای مثال: «نزدیک ساختمان امپایر استیت» یا «روبروی کاخ سفید».

tags[]

Landmark.Tag

برچسب‌هایی که نحوه استفاده از آن بنای تاریخی را در متن مقصد توصیف می‌کنند.

straight_line_distance_meters

double

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

travel_distance_meters

double

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

landmark میدان یونیون. علامت مشخصه. landmark می‌تواند فقط یکی از موارد زیر باشد:
place

PlaceView

مکانی که نمایانگر این بنای تاریخی است.

برچسب

فهرست تمام برچسب‌های ممکن که نحوهٔ استفاده از یک نشان تاریخی را در متن یک مقصد توصیف می‌کنند.

اگر آدرسی هم برچسب ADDRESS و هم ARRIVAL داشته باشد، به این معنی است که آن مکان هم از نظر محلی برجسته است و هم به مقصد نزدیک.

انوم‌ها
TAG_UNSPECIFIED استفاده نشده.
ADDRESS یک مکان برجسته محلی که می‌تواند برای شناسایی موقعیت کلی مقصد استفاده شود. معمولاً در فاصله چند صد متری از مقصد. این مکان‌ها مشابه نشانه‌هایی هستند که توسط ویژگی Address Descriptors از Geocoding API برگردانده می‌شوند: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors .
ARRIVAL مکانی که می‌تواند برای کمک به رسیدن به مقصد استفاده شود. برای ناوبری زمانی که به مقصد نزدیک هستید مفید است. برای مثال، این مکان دیدنی ممکن است مکانی باشد که در آن سوی خیابان از مقصد قرار دارد. یک مکان دیدنی با این برچسب معمولاً به مقصد نزدیک‌تر از مکان‌های دیدنی با برچسب ADDRESS است.

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

فیلدها
navigation_point_token

string

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

display_name

LocalizedText

نام نمایشی این نقطه ناوبری. مثلاً «خیابان پنجم» یا «دروازه B».

location

LatLng

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

travel_modes[]

NavigationPoint.TravelMode

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

usages[]

NavigationPoint.Usage

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

حالت سفر

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

انوم‌ها
TRAVEL_MODE_UNSPECIFIED استفاده نشده.
DRIVE مناسب برای رانندگی.
WALK مناسب برای پیاده‌روی.

کاربرد

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

انوم‌ها
USAGE_UNSPECIFIED استفاده نشده.
UNKNOWN نوع استفاده ناشناخته. اکثر نقاط ناوبری UNKNOWN خواهند بود و لزوماً به این معنی نیست که استفاده از آنها به هیچ وجه محدود شده است. این ناوبری ممکن است هنوز برای تحویل و/یا تحویل مناسب باشد.
DROPOFF مناسب برای پیاده کردن مسافر. به عنوان مثال، محل پیاده کردن مسافر در سفرهای اشتراکی.
PICKUP مناسب برای سوار کردن مسافر. به عنوان مثال، یک مکان سوار شدن به صورت اشتراکی.

نمای مکان

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

در برخی موارد، یک PlaceView با شناسه مکان یکسان ممکن است با آنچه توسط Places API برای فیلدهای types و display_name برگردانده می‌شود، متفاوت باشد.

فیلدها
place

string

نام منبع این مکان، با فرمت places/{placeId} .

display_name

LocalizedText

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

primary_type

string

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

توجه: این فیلد همیشه پر نمی‌شود. در چنین شرایطی آماده باشید که از فیلد types استفاده کنید.

types[]

string

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

formatted_address

string

آدرس تک خطی.

postal_address

PostalAddress

آدرس ساختار یافته

structure_type

PlaceView.StructureType

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

location

LatLng

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

display_polygon

Struct

طرح کلی چندضلعی مکان در قالب GeoJSON، با استفاده از قالب RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6 .

نکته: فرمت RFC 7946 از MultiPolygons پشتیبانی می‌کند، بنابراین یک شیء display_polygon می‌تواند چندین چندضلعی را نمایش دهد.

نوع ساختار

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

انوم‌ها
STRUCTURE_TYPE_UNSPECIFIED استفاده نشده.
POINT یک موقعیت نقطه‌ای.
SECTION بخشی فرعی از یک ساختمان.
BUILDING یک ساختمان.
GROUNDS یک منطقه بزرگ که معمولاً شامل چندین ساختمان است، مانند یک دانشگاه، یک مجتمع آپارتمانی یا یک مرکز خرید.

پلاس‌کد

کد پلاس ( http://plus.codes ) یک مرجع مکان با دو قالب است: کد سراسری که مستطیلی به ابعاد ۱۴ در ۱۴ متر (۱/۸۰۰۰ درجه) یا کوچکتر را تعریف می‌کند، و کد مرکب که پیشوند را با یک مکان مرجع جایگزین می‌کند.

فیلدها
global_code

string

کد سراسری (کامل) یک مکان، مانند "9FWM33GV+HQ"، که نشان‌دهنده‌ی منطقه‌ای با ابعاد ۱/۸۰۰۰ در ۱/۸۰۰۰ درجه (حدود ۱۴ در ۱۴ متر) است.

compound_code

string

کد مرکب مکان، مانند "33GV+HQ, Ramberg, Norway"، که شامل پسوند کد جهانی است و پیشوند را با نام قالب‌بندی‌شده‌ی یک موجودیت مرجع جایگزین می‌کند.

جستجومقصدهادرخواست

درخواست پیام برای DestinationService.SearchDestinations.

فیلدها
travel_modes[]

NavigationPoint.TravelMode

اختیاری. حالت‌های سفر برای فیلتر کردن نقاط ناوبری. این بر فیلد navigation_points که در پاسخ برگردانده می‌شود تأثیر می‌گذارد. اگر خالی باشد، نقاط ناوبری همه حالت‌های سفر می‌توانند برگردانده شوند.

language_code

string

اختیاری. زبانی که نتایج باید با آن برگردانده شوند.

region_code

string

اختیاری. کد منطقه. کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. این پارامتر بر اساس قانون مربوطه بر نتایج تأثیر می‌گذارد. این پارامتر همچنین بر نتایج حاصل از سرویس تأثیر می‌گذارد، اما آنها را به طور کامل محدود نمی‌کند.

فیلد primary_query نوع Union. درخواست برای مقصد اصلی. این می‌تواند یک مکان، یک آدرس کاملاً مشخص یا یک مکان LatLng باشد. برخی از مکان‌ها و آدرس‌ها با حداقل اطلاعات، قابل تبدیل به مقصد نیستند.

مقصدها حول پرس‌وجوی اصلی مشخص‌شده ساخته می‌شوند.

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

place

string

نام منبع یک مکان، با فرمت places/{place_id} .

address_query

SearchDestinationsRequest.AddressQuery

آدرس خیابان.

location_query

SearchDestinationsRequest.LocationQuery

یک مکان دقیق.

پرس و جوی آدرس

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

فیلدها
فیلد Union kind . kind پرس و جوی آدرس فقط می‌تواند یکی از موارد زیر باشد:
address

PostalAddress

آدرس خیابان در قالب آدرس پستی.

address_query

string

آدرس خیابان که به صورت تک خطی قالب‌بندی شده است.

جستجوی موقعیت مکانی

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

نکته: اگر درخواست موقعیت مکانی در داخل ساختمانی باشد که شامل ساختمان‌های فرعی است، ممکن است مکان اصلی برگردانده شده یک ساختمان فرعی باشد. در این موارد، فیلد containing_places شامل ساختمان نیز خواهد بود.

فیلدها
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

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

kind فیلد Union. kind پرس و جوی مکان فقط می‌تواند یکی از موارد زیر باشد:
location

LatLng

یک مکان دقیق LatLng.

فیلتر مکان

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

فیلدها
structure_type

PlaceView.StructureType

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

برای مثال، اگر GROUNDS مشخص شده باشد، تمام مقصدهای برگشتی یک مکان اصلی با نوع ساختار GROUNDS خواهند داشت. این می‌تواند منجر به فیلتر کردن برخی از مقصدهایی شود که بخشی از یک grounds نیستند، یا منجر به کاهش تعداد مقصدهای برگشتی به سطح grounds شود.

یکی دیگر از کاربردهای این فیلد، استخراج آسان‌تر چندضلعی‌های نمایش ساختمان است. برای مثال، اگر BUILDING مشخص شده باشد، چندضلعی نمایش مکان اصلی، ساختمان واقع در مکان مشخص شده خواهد بود.

addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

اختیاری. در صورت مشخص شدن، فقط مقصدهایی را برمی‌گرداند که معیارهای آدرس‌پذیری مربوطه را برآورده می‌کنند.

آدرس پذیری

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

انوم‌ها
ADDRESSABILITY_UNSPECIFIED وقتی مشخص نشده باشد، سرویس یک پیش‌فرض معقول را انتخاب می‌کند.
ANY آدرس‌پذیری معیار فیلترینگ نیست. مقصدها صرف نظر از آدرس‌پذیری‌شان برگردانده می‌شوند.
PRIMARY تمام مقاصد برگردانده شده دارای یک مکان اصلی با آدرس یا نام در سطح خیابان خواهند بود.
WEAK تمام مقصدهای برگردانده شده یا یک مکان اصلی یا یک مقصد فرعی با آدرس یا نام خیابان خواهند داشت.

جستجومقصدهاپاسخ

پیام پاسخ برای DestinationService.SearchDestinations.

فیلدها
destinations[]

Destination

فهرستی از مقاصد.

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