Package google.maps.geocode.v4beta

شاخص

GeocodeService

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

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

rpc GeocodeAddress( GeocodeAddressRequest ) returns ( GeocodeAddressResponse )

این روش یک ژئوکد آدرس را انجام می دهد که یک آدرس را به یک 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 )

این روش یک ژئوکد مکان را انجام می دهد که یک 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
GeocodePlace

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

GeocodeAddressRequest

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

فیلدها
location_bias

GeocodeAddressRequest.LocationBias

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

language_code

string

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

region_code

string

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

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

string

آدرس بدون ساختار به ژئوکد.

address

PostalAddress

آدرس ساخت یافته به geocode در قالب آدرس پستی.

LocationBias

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

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

Viewport

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

GeocodeAddressResponse

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

فیلدها
results[]

GeocodeResult

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

GeocodeLocation Request

درخواست پیام برای 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

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

فیلد اتحادیه location_input . مکان به ژئوکد. location_input تنها می تواند یکی از موارد زیر باشد:
location_query

string

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

location

LatLng

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

GeocodeLocationResponse

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

فیلدها
results[]

GeocodeResult

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

plus_code

PlusCode

کد پلاس مکان در درخواست.

GeocodePlaceRequest

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

فیلدها
place

string

مورد نیاز. شناسه مکان به ژئوکد در قالب مکان‌ها/{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

مجموعه ای از برچسب های نوع برای این نتیجه. مثلاً «سیاسی» و «منطقه_administrative».

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

plus_code

PlusCode

کد پلاس مکان در این ژئوکد.

Address Component

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

فیلدها
long_text

string

شرح متن کامل یا نام جزء آدرس. به عنوان مثال، یک جزء آدرس برای کشور استرالیا ممکن است نام طولانی "Australia" داشته باشد.

short_text

string

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

types[]

string

آرایه ای که نوع(های) جزء آدرس را نشان می دهد.

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

language_code

string

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

دانه بندی

دانه بندی محل.

Enums
GRANULARITY_UNSPECIFIED استفاده نکنید.
ROOFTOP مکان غیر درون یابی یک قطعه زمین واقعی مطابق با آدرس منطبق.
RANGE_INTERPOLATED درون یابی از طیف وسیعی از شماره های خیابان. به عنوان مثال، اگر می دانیم که بخشی از Amphitheatre Pkwy دارای اعداد 1600 - 1699 است، ممکن است 1650 در نیمه راه بین نقاط انتهایی آن قرار گیرد.
GEOMETRIC_CENTER مرکز هندسی یک ویژگی که داده های چند ضلعی برای آن داریم.
APPROXIMATE همه چیز دیگر.

پلاس کد

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

فیلدها
global_code

string

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

compound_code

string

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