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 . فقط نتایجی که با تمام فیلترها مطابقت داشته باشند برگردانده می شوند. مقادیر فیلتر از همان روش‌های تصحیح املا و تطبیق جزئی مانند سایر درخواست‌های کدگذاری جغرافیایی پشتیبانی می‌کنند. اختیاری.
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 مطابقت دارد. اختیاری.

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 است.

results
نوع: Array < GeocoderResult >
لیست GeocoderResult s.

رابط GeocoderResult

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

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

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

رابط GeocoderAddressComponent

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

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

long_name
نوع: string
متن کامل جزء آدرس
short_name
نوع: string
متن کوتاه و کوتاه جزء آدرس داده شده
types
نوع: Array <string>
آرایه ای از رشته ها که نوع این جزء آدرس را نشان می دهد. لیستی از انواع معتبر را می توان در اینجا یافت

رابط GeocoderGeometry

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

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

location
نوع: LatLng
مختصات طول و عرض جغرافیایی این نتیجه
location_type
نوع مکان برگردانده شده در location
viewport
نوع: LatLngBounds
مرزهای نمای پیشنهادی برای نمایش این GeocoderResult
bounds optional
نوع: LatLngBounds optional
مرزهای دقیق این GeocoderResult ، در صورت وجود

ثابت های GeocoderLocationType

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

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

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

APPROXIMATE نتیجه برگشتی تقریبی است.
GEOMETRIC_CENTER نتیجه برگشتی مرکز هندسی یک نتیجه مانند خط (به عنوان مثال خیابان) یا چند ضلعی (منطقه) است.
RANGE_INTERPOLATED نتیجه برگشتی یک تقریب (معمولاً در یک جاده) را نشان می دهد که بین دو نقطه دقیق (مانند تقاطع ها) درون یابی شده است. نتایج درون یابی عموماً زمانی که ژئوکدهای روی پشت بام برای یک آدرس خیابان در دسترس نباشند، برمی گردند.
ROOFTOP نتیجه برگشتی یک ژئوکد دقیق را منعکس می کند.