Geocoder

کلاس ژئوکدر

google.maps . Geocoder کلاس google.maps . Geocoder

سرویسی برای تبدیل بین یک آدرس و یک LatLng .

با فراخوانی const {Geocoder} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط GeocoderRequest

google.maps . GeocoderRequest رابط google.maps . GeocoderRequest

مشخصات درخواست ژئوکدینگ برای ارسال به Geocoder .

خواص
address optional	نوع: string optional آدرس به ژئوکد یک و تنها یک address ، location و placeId باید ارائه شود.
bounds optional	نوع: LatLngBounds | LatLngBoundsLiteral optional LatLngBounds که در آن جستجو کنید. اختیاری.
componentRestrictions optional	نوع: GeocoderComponentRestrictions optional کامپوننت ها برای محدود کردن نتایج به یک منطقه خاص استفاده می شوند. یک فیلتر از یک یا چند مورد تشکیل شده است: route ، locality ، administrativeArea ، postalCode ، country . فقط نتایجی که با تمام فیلترها مطابقت داشته باشند برگردانده می شوند. مقادیر فیلتر از همان روش‌های تصحیح املا و تطبیق جزئی مانند سایر درخواست‌های کدگذاری جغرافیایی پشتیبانی می‌کنند. اختیاری.
extraComputations optional	نوع: Array < ExtraGeocodeComputation > optional فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند.
fulfillOnZeroResults optional	نوع: boolean optional در پاسخ به قول وضعیت ZERO_RESULT عمل کنید. این ممکن است مطلوب باشد زیرا حتی با نتایج صفر کدگذاری جغرافیایی، ممکن است هنوز فیلدهای سطح پاسخ اضافی برگردانده شوند.
language optional	نوع: string optional شناسه زبان برای زبانی که نتایج باید در صورت امکان به آن بازگردانده شوند. لیست زبان های پشتیبانی شده را ببینید.
location optional	نوع: LatLng | LatLngLiteral optional LatLng (یا LatLngLiteral ) که برای جستجو. ژئوکدر یک ژئوکد معکوس را انجام می دهد. برای اطلاعات بیشتر Reverse Geocoding را ببینید. یک و تنها یک address ، location و placeId باید ارائه شود.
placeId optional	نوع: string optional شناسه مکان مرتبط با مکان. شناسه‌های مکان به طور منحصربه‌فردی یک مکان را در پایگاه داده Google Places و در Google Maps شناسایی می‌کنند. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید. ژئوکدر یک ژئوکد معکوس را انجام می دهد. برای اطلاعات بیشتر Reverse Geocoding را ببینید. یک و تنها یک address ، location و placeId باید ارائه شود.
region optional	نوع: string optional کد کشور مورد استفاده برای سوگیری جستجو، مشخص شده به عنوان یک زیربرچسب منطقه یونیکد دو کاراکتری (غیر عددی) / شناسه CLDR. اختیاری. جزئیات پوشش پلت فرم Google Maps را برای مناطق پشتیبانی شده ببینید.

رابط GeocoderComponentRestrictions

google.maps . GeocoderComponentRestrictions رابط google.maps . GeocoderComponentRestrictions

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

ثابت های محاسبه ExtraGeocode

google.maps . ExtraGeocodeComputation ثابت های google.maps . ExtraGeocodeComputation

محاسبات اضافی برای انجام در هنگام تکمیل درخواست کدگذاری جغرافیایی.

با فراخوانی const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

GeocoderStatus ثابت

google.maps . GeocoderStatus ثابت

وضعیتی که توسط Geocoder پس از تکمیل فراخوانی به geocode() باز می گردد. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.GeocoderStatus.OK .

با فراخوانی const {GeocoderStatus} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط GeocoderResponse

google.maps . GeocoderResponse رابط google.maps . GeocoderResponse

پاسخ Geocoder که توسط Geocoder حاوی لیست GeocoderResult s است.

خواص
results	نوع: Array < GeocoderResult > لیست GeocoderResult s.
address_descriptor optional	نوع: AddressDescriptor optional توصیف رابطه ای از یک مکان. شامل مجموعه‌ای رتبه‌بندی شده از نشانه‌های نزدیک و نواحی حاوی مکان هدف است. فقط برای درخواست‌های کدگذاری معکوس جغرافیایی و فقط زمانی که ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فعال باشد، پر می‌شود.
plus_code optional	نوع: PlacePlusCode optional کد مثبت مرتبط با مکان.

رابط GeocoderResult

google.maps . GeocoderResult رابط google.maps . GeocoderResult

یک نتیجه ژئوکدر منفرد از سرور ژئوکد بازیابی شده است. یک درخواست ژئوکد ممکن است چندین شیء نتیجه را برگرداند. توجه داشته باشید که اگرچه این نتیجه "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا به طور غیرمستقیم شامل یک شی LatLng است.

خواص
address_components	نوع: Array < GeocoderAddressComponent > آرایه ای از GeocoderAddressComponent s
formatted_address	نوع: string رشته ای حاوی آدرس قابل خواندن توسط انسان این مکان.
geometry	نوع: GeocoderGeometry یک شی GeocoderGeometry
place_id	نوع: string شناسه مکان مرتبط با مکان. شناسه‌های مکان به طور منحصربه‌فردی یک مکان را در پایگاه داده Google Places و در Google Maps شناسایی می‌کنند. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید.
types	نوع: Array <string> آرایه‌ای از رشته‌ها که نوع عنصر ژئوکد برگشتی را نشان می‌دهد. برای لیست رشته های احتمالی، به بخش Address Component Types در Developer's Guide مراجعه کنید.
address_descriptor optional	نوع: AddressDescriptor optional توصیف رابطه‌ای از مکان مرتبط با این ژئوکد. شامل مجموعه ای رتبه بندی شده از نشانه های نزدیک و مناطق حاوی مکان مورد نظر است. فقط زمانی که ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فعال باشد و فقط برای مکان‌های محلی خاص، این مورد فقط برای درخواست‌های جستجوی شناسه جغرافیایی و شناسه مکان به جلو پر می‌شود.
partial_match optional	نوع: boolean optional این که آیا geocoder مطابقت دقیق درخواست اصلی را برنمی‌گرداند، اگرچه می‌توانست بخشی از آدرس درخواستی را مطابقت دهد. اگر مطابقت دقیق باشد، مقدار آن undefined است.
plus_code optional	نوع: PlacePlusCode optional کد مثبت مرتبط با مکان.
postcode_localities optional	نوع: Array <string> optional آرایه‌ای از رشته‌ها که همه مکان‌های موجود در یک کد پستی را نشان می‌دهد. این تنها زمانی وجود دارد که نتیجه یک کد پستی باشد که دارای چندین محل باشد.

رابط AddressDescriptor

google.maps . AddressDescriptor رابط google.maps . AddressDescriptor

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

رابط GeocoderAddressComponent

google.maps . GeocoderAddressComponent رابط google.maps . GeocoderAddressComponent

یک جزء آدرس واحد در یک GeocoderResult . یک آدرس کامل ممکن است از چندین جزء آدرس تشکیل شده باشد.

رابط GeocoderGeometry

google.maps . GeocoderGeometry رابط google.maps . GeocoderGeometry

اطلاعات هندسی در مورد این GeocoderResult

ثابت‌های GeocoderLocationType

google.maps . GeocoderLocationType ثابت‌های google.maps . GeocoderLocationType

نوع مکان بازگشتی از یک ژئوکد را توصیف می کند. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'ROOFTOP' یا google.maps.GeocoderLocationType.ROOFTOP .

با فراخوانی const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط برجسته

google.maps . Landmark رابط google.maps . Landmark

مکانی که نشان دهنده یک نقطه مرجع برای آدرس است.

رابط منطقه

google.maps . Area رابط google.maps . Area

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

ثابت های مهار

google.maps . Containment ثابت های google.maps . Containment

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

با فراخوانی const {Containment} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

ثابت های رابطه فضایی

google.maps . SpatialRelationship ثابت های google.maps . SpatialRelationship

یک عدد نشان دهنده رابطه در فضای بین نقطه عطف و هدف.

با فراخوانی const {SpatialRelationship} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

کلاس ژئوکدر

google.maps . Geocoder کلاس google.maps . Geocoder

سرویسی برای تبدیل بین یک آدرس و یک LatLng .

با فراخوانی const {Geocoder} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط GeocoderRequest

google.maps . GeocoderRequest رابط google.maps . GeocoderRequest

مشخصات درخواست ژئوکدینگ برای ارسال به Geocoder .

خواص
address optional	نوع: string optional آدرس به ژئوکد یک و تنها یک address ، location و placeId باید ارائه شود.
bounds optional	نوع: LatLngBounds | LatLngBoundsLiteral optional LatLngBounds که در آن جستجو کنید. اختیاری.
componentRestrictions optional	نوع: GeocoderComponentRestrictions optional کامپوننت ها برای محدود کردن نتایج به یک منطقه خاص استفاده می شوند. یک فیلتر از یک یا چند مورد تشکیل شده است: route ، locality ، administrativeArea ، postalCode ، country . فقط نتایجی که با همه فیلترها مطابقت دارند برگردانده می شوند. مقادیر فیلتر از همان روش‌های تصحیح املا و تطابق جزئی مانند سایر درخواست‌های کدگذاری جغرافیایی پشتیبانی می‌کنند. اختیاری.
extraComputations optional	نوع: Array < ExtraGeocodeComputation > optional فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را بر روی پاسخ بازگرداند.
fulfillOnZeroResults optional	نوع: boolean optional در پاسخ به قول وضعیت ZERO_RESULT عمل کنید. این ممکن است مورد نظر باشد زیرا حتی با صفر بودن نتایج کدگذاری جغرافیایی، ممکن است هنوز فیلدهای سطح پاسخ اضافی بازگردانده شوند.
language optional	نوع: string optional شناسه زبان برای زبانی که نتایج باید در صورت امکان به آن بازگردانده شوند. لیست زبان های پشتیبانی شده را ببینید.
location optional	نوع: LatLng | LatLngLiteral optional LatLng (یا LatLngLiteral ) که برای جستجو. ژئوکدر یک ژئوکد معکوس را انجام می دهد. برای اطلاعات بیشتر Reverse Geocoding را ببینید. یک و تنها یک address ، location و placeId باید ارائه شود.
placeId optional	نوع: string optional شناسه مکان مرتبط با مکان. شناسه‌های مکان به طور منحصربه‌فردی یک مکان را در پایگاه داده Google Places و در Google Maps شناسایی می‌کنند. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید. ژئوکدر یک ژئوکد معکوس را انجام می دهد. برای اطلاعات بیشتر Reverse Geocoding را ببینید. یک و تنها یک address ، location و placeId باید ارائه شود.
region optional	نوع: string optional کد کشوری که برای سوگیری جستجو استفاده می‌شود، که به‌عنوان یک زیربرچسب منطقه یونیکد دو کاراکتری (غیر عددی) / شناسه CLDR مشخص شده است. اختیاری. جزئیات پوشش پلت فرم Google Maps را برای مناطق پشتیبانی شده ببینید.

رابط GeocoderComponentRestrictions

google.maps . GeocoderComponentRestrictions رابط google.maps . GeocoderComponentRestrictions

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

ثابت های محاسبه ExtraGeocode

google.maps . ExtraGeocodeComputation ثابت های google.maps . ExtraGeocodeComputation

محاسبات اضافی برای انجام در هنگام تکمیل درخواست کدگذاری جغرافیایی.

با فراخوانی const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

GeocoderStatus ثابت

google.maps . GeocoderStatus ثابت

وضعیتی که توسط Geocoder پس از تکمیل فراخوانی به geocode() باز می گردد. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.GeocoderStatus.OK .

با فراخوانی const {GeocoderStatus} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط GeocoderResponse

google.maps . GeocoderResponse رابط google.maps . GeocoderResponse

پاسخ Geocoder که توسط Geocoder حاوی لیست GeocoderResult s است.

خواص
results	نوع: Array < GeocoderResult > لیست GeocoderResult s.
address_descriptor optional	نوع: AddressDescriptor optional توصیف رابطه ای از یک مکان. شامل مجموعه ای رتبه بندی شده از نشانه های نزدیک و مناطق حاوی مکان مورد نظر است. فقط برای درخواست‌های معکوس کدگذاری جغرافیایی و فقط زمانی که ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فعال باشد، پر می‌شود.
plus_code optional	نوع: PlacePlusCode optional کد مثبت مرتبط با مکان.

رابط GeocoderResult

google.maps . GeocoderResult رابط google.maps . GeocoderResult

یک نتیجه ژئوکدر منفرد از سرور ژئوکد بازیابی شده است. یک درخواست ژئوکد ممکن است چندین شیء نتیجه را برگرداند. توجه داشته باشید که اگرچه این نتیجه "JSON-مانند" است، اما به طور دقیق JSON نیست، زیرا به طور غیرمستقیم شامل یک شی LatLng است.

خواص
address_components	نوع: Array < GeocoderAddressComponent > آرایه ای از GeocoderAddressComponent s
formatted_address	نوع: string رشته ای حاوی آدرس قابل خواندن توسط انسان این مکان.
geometry	نوع: GeocoderGeometry یک شی GeocoderGeometry
place_id	نوع: string شناسه مکان مرتبط با مکان. شناسه‌های مکان به طور منحصربه‌فردی یک مکان را در پایگاه داده Google Places و در Google Maps شناسایی می‌کنند. در راهنمای برنامه‌نویس Places API درباره شناسه‌های مکان بیشتر بیاموزید.
types	نوع: Array <string> آرایه‌ای از رشته‌ها که نوع عنصر ژئوکد برگشتی را نشان می‌دهد. برای لیست رشته های احتمالی، به بخش Address Component Types در Developer's Guide مراجعه کنید.
address_descriptor optional	نوع: AddressDescriptor optional توصیف رابطه ای از مکان مرتبط با این ژئوکد. شامل مجموعه ای رتبه بندی شده از نشانه های نزدیک و مناطق حاوی مکان مورد نظر است. فقط زمانی که ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فعال باشد و فقط برای مکان‌های محلی خاص، این مورد فقط برای درخواست‌های جستجوی شناسه جغرافیایی و شناسه مکان به جلو پر می‌شود.
partial_match optional	نوع: boolean optional این که آیا geocoder مطابقت دقیق درخواست اصلی را برنمی‌گرداند، اگرچه می‌توانست بخشی از آدرس درخواستی را مطابقت دهد. اگر مطابقت دقیق باشد، مقدار آن undefined است.
plus_code optional	نوع: PlacePlusCode optional کد مثبت مرتبط با مکان.
postcode_localities optional	نوع: Array <string> optional آرایه‌ای از رشته‌ها که همه مکان‌های موجود در یک کد پستی را نشان می‌دهد. این فقط زمانی وجود دارد که نتیجه یک کد پستی باشد که دارای چندین مکان باشد.

رابط AddressDescriptor

google.maps . AddressDescriptor رابط google.maps . AddressDescriptor

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

رابط GeocoderAddressComponent

google.maps . GeocoderAddressComponent رابط google.maps . GeocoderAddressComponent

یک جزء آدرس واحد در یک GeocoderResult . یک آدرس کامل ممکن است از چندین جزء آدرس تشکیل شده باشد.

رابط GeocoderGeometry

google.maps . GeocoderGeometry رابط google.maps . GeocoderGeometry

اطلاعات هندسی در مورد این GeocoderResult

ثابت های GeocoderLocationType

google.maps . GeocoderLocationType ثابت های google.maps . GeocoderLocationType

نوع مکان بازگشتی از یک ژئوکد را توصیف می کند. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'ROOFTOP' یا google.maps.GeocoderLocationType.ROOFTOP .

با فراخوانی const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

رابط نقطه عطفی

google.maps . Landmark رابط google.maps . Landmark

مکانی که نشان دهنده یک نقطه مرجع برای آدرس است.

رابط منطقه

google.maps . Area رابط google.maps . Area

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

ثابت های مهار

google.maps . Containment ثابت های google.maps . Containment

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

با فراخوانی const {Containment} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

ثابت های رابطه فضایی

google.maps . SpatialRelationship ثابت های google.maps . SpatialRelationship

یک عدد نشان دهنده رابطه در فضای بین نقطه عطف و هدف.

با فراخوانی const {SpatialRelationship} = await google.maps.importLibrary("geocoding") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.