روشهای Geocoding API نسخه ۴ سهمیه پیشفرض ۲۵ پرسوجو در ثانیه (QPS) دارند. برای اطلاعات بیشتر در مورد درخواست سهمیه بالاتر، به بخش
«مشاهده و مدیریت سهمیهها» مراجعه کنید و
Geocoding API را به عنوان سرویس انتخاب کنید.
ارسال بازخورد
GeocodeResult
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نتیجهی کد جغرافیایی شامل اطلاعات جغرافیایی در مورد یک مکان است.
نمایش JSON
{
"place" : string ,
"placeId" : string ,
"location" : {
object (LatLng )
} ,
"granularity" : enum (GeocodeResult.Granularity ) ,
"viewport" : {
object (Viewport )
} ,
"bounds" : {
object (Viewport )
} ,
"formattedAddress" : string ,
"postalAddress" : {
object (PostalAddress )
} ,
"addressComponents" : [
{
object (GeocodeResult.AddressComponent )
}
] ,
"postalCodeLocalities" : [
{
object (LocalizedText )
}
] ,
"types" : [
string
] ,
"plusCode" : {
object (PlusCode )
}
}
فیلدها place string
نام منبع این مکان، با فرمت places/{placeId} . میتوان از آن برای جستجوی مکان استفاده کرد.
placeId string
شناسه منحصر به فرد یک مکان.
location object ( LatLng )
طول این آدرس.
granularity enum ( GeocodeResult.Granularity )
جزئیات مکان.
viewport object ( Viewport )
یک نمای مناسب برای نمایش نتیجه ژئوکد.
bounds object ( Viewport )
یک کادر محدودکننده برای آدرس.
formattedAddress string
آدرس با فرمت تک خطی.
postalAddress object ( PostalAddress )
آدرس در قالب آدرس پستی.
addressComponents[] object ( GeocodeResult.AddressComponent )
اجزای تکراری برای هر سطح محلی.
postalCodeLocalities[] object ( LocalizedText )
فهرست کامل محلهای ذکر شده در کد پستی.
این فقط زمانی پر میشود که نتیجه از نوع "postal_code" باشد.
types[] string
مجموعهای از برچسبهای نوع برای این نتیجه. به عنوان مثال، "political" و "administrative_area".
برای لیست کامل مقادیر ممکن، به جدول A و جدول B در آدرس https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.
plusCode object ( PlusCode )
کد بعلاوه مکان در این کد جغرافیایی.
کامپوننت آدرس نتیجه کد جغرافیایی اجزای ساختاریافتهای که آدرس قالببندیشده را تشکیل میدهند، در صورتی که این اطلاعات در دسترس باشد.
نمایش JSON
{
"longText" : string ,
"shortText" : string ,
"types" : [
string
] ,
"languageCode" : string
}
فیلدها longText string
توضیحات کامل متنی یا نام کامپوننت آدرس. برای مثال، یک کامپوننت آدرس برای کشور استرالیا ممکن است نام طولانی "Australia" داشته باشد.
shortText string
در صورت وجود، یک نام متنی مختصر برای مؤلفه آدرس. برای مثال، یک مؤلفه آدرس برای کشور استرالیا ممکن است نام کوتاه "AU" داشته باشد.
types[] string
آرایهای که نوع(های) مؤلفه آدرس را نشان میدهد.
برای جزئیات بیشتر به https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types مراجعه کنید.
languageCode string
زبانی که برای قالببندی این مؤلفه استفاده شده است، با نمادگذاری CLDR.
ارسال بازخورد
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-03-31 بهوقت ساعت هماهنگ جهانی.
میخواهید موارد بیشتری را با ما درمیان بگذارید؟
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-03-31 بهوقت ساعت هماهنگ جهانی."],[],[]]