Geocoder

کلاس ژئوکدر

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

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

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

Geocoder
Geocoder()
پارامترها: ندارد
نمونه جدیدی از Geocoder ایجاد می کند که درخواست های geocode را به سرورهای Google ارسال می کند.
geocode
geocode(request[, callback])
پارامترها:
مقدار بازگشتی: Promise < GeocoderResponse >
ژئوکد یک درخواست

رابط GeocoderRequest

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

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

address optional
نوع: string optional
آدرس به ژئوکد یک و تنها یک address ، location و placeId باید ارائه شود.
bounds optional
نوع: LatLngBounds | LatLngBoundsLiteral optional
LatLngBounds که در آن جستجو کنید. اختیاری.
componentRestrictions optional
کامپوننت ها برای محدود کردن نتایج به یک منطقه خاص استفاده می شوند. یک فیلتر از یک یا چند مورد تشکیل شده است: route ، locality ، administrativeArea ، postalCode ، country . فقط نتایجی که با تمام فیلترها مطابقت داشته باشند برگردانده می شوند. مقادیر فیلتر از همان روش‌های تصحیح املا و تطبیق جزئی مانند سایر درخواست‌های کدگذاری جغرافیایی پشتیبانی می‌کنند. اختیاری.
Beta 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 مجموعه‌ای از فیلترها را نشان می‌دهد که در یک منطقه خاص حل می‌شوند. برای جزئیات بیشتر در مورد نحوه عملکرد، به فیلتر کردن مؤلفه های کدگذاری جغرافیایی مراجعه کنید.

administrativeArea optional
نوع: string optional
با تمام administrative_area levels مطابقت دارد. اختیاری.
country optional
نوع: string optional
با نام کشور یا کد کشور ISO 3166-1 دو حرفی مطابقت دارد. اختیاری.
locality optional
نوع: string optional
با هر دو نوع locality و sublocality مطابقت دارد. اختیاری.
postalCode optional
نوع: string optional
postal_code و postal_code_prefix مطابقت دارد. اختیاری.
route optional
نوع: string optional
با نام بلند یا کوتاه یک route مطابقت دارد. اختیاری.

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

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

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

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

ADDRESS_DESCRIPTORS یک توصیفگر آدرس ایجاد کنید.

GeocoderStatus ثابت

google.maps . GeocoderStatus ثابت

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

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

ERROR مشکلی در تماس با سرورهای Google وجود داشت.
INVALID_REQUEST این GeocoderRequest نامعتبر بود.
OK پاسخ حاوی یک GeocoderResponse معتبر است.
OVER_QUERY_LIMIT صفحه وب در مدت زمان بسیار کوتاهی از محدودیت درخواست‌ها فراتر رفته است.
REQUEST_DENIED صفحه وب مجاز به استفاده از geocoder نیست.
UNKNOWN_ERROR به دلیل خطای سرور، درخواست کدگذاری جغرافیایی پردازش نشد. اگر دوباره تلاش کنید ممکن است درخواست با موفقیت انجام شود.
ZERO_RESULTS هیچ نتیجه ای برای این GeocoderRequest یافت نشد.

رابط GeocoderResponse

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

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