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.googleapis.com/places/{placeID}". لمزيد من التفاصيل، يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/place-id.
|
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
مجموعة من علامات النوع لهذه النتيجة على سبيل المثال، "سياسي" و "منطقة إدارية". للاطّلاع على القائمة الكاملة بالقيم المحتملة، يُرجى الرجوع إلى الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
|
plusCode |
object (PlusCode )
رمز Plus Codes للموقع الجغرافي في هذا الرمز الجغرافي
|
GeocodeResult.AddressComponent
المكوّنات المنظَّمة التي تشكّل العنوان المنسَّق، إذا كانت هذه المعلومات متاحة
تمثيل JSON |
{
"longText": string,
"shortText": string,
"types": [
string
],
"languageCode": string
} |
الحقول |
longText |
string
الوصف النصي الكامل أو اسم مكوّن العنوان. على سبيل المثال، قد يتضمّن أحد مكوّنات العنوان الخاص ببلد أستراليا اسمًا طويلاً هو "أستراليا".
|
shortText |
string
اسم نصي مختصر لمكوّن العنوان، إذا كان متاحًا على سبيل المثال، قد يتضمّن أحد عناصر العنوان الخاص ببلد أستراليا اسمًا مختصرًا هو "AU".
|
types[] |
string
مصفوفة تشير إلى أنواع مكوّنات العنوان. يمكنك الاطّلاع على https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types لمزيد من التفاصيل.
|
languageCode |
string
اللغة المستخدَمة لتنسيق هذه المكوّنات، بتنسيق CLDR
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# GeocodeResult\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [GeocodeResult.AddressComponent](#GeocodeResult.AddressComponent)\n - [JSON representation](#GeocodeResult.AddressComponent.SCHEMA_REPRESENTATION)\n\nA geocode result contains geographic information about a place.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"place\": string, \"placeId\": string, \"location\": { object (/maps/documentation/geocoding/reference/rest/Shared.Types/LatLng) }, \"granularity\": enum (/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult.Granularity), \"viewport\": { object (/maps/documentation/geocoding/reference/rest/v4beta/Viewport) }, \"bounds\": { object (/maps/documentation/geocoding/reference/rest/v4beta/Viewport) }, \"formattedAddress\": string, \"postalAddress\": { object (/maps/documentation/geocoding/reference/rest/Shared.Types/PostalAddress) }, \"addressComponents\": [ { object (/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult#GeocodeResult.AddressComponent) } ], \"postalCodeLocalities\": [ { object (/maps/documentation/geocoding/reference/rest/Shared.Types/LocalizedText) } ], \"types\": [ string ], \"plusCode\": { object (/maps/documentation/geocoding/reference/rest/v4beta/PlusCode) } } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `place` | `string` The fully qualified place identifier for this result. In the format of \"//places.googleapis.com/places/{placeID}\". See \u003chttps://developers.google.com/maps/documentation/places/web-service/place-id\u003e. for more details. |\n| `placeId` | `string` The place ID for this result. |\n| `location` | `object (`[LatLng](/maps/documentation/geocoding/reference/rest/Shared.Types/LatLng)`)` The latlng of this address. |\n| `granularity` | `enum (`[GeocodeResult.Granularity](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult.Granularity)`)` The granularity of the location. |\n| `viewport` | `object (`[Viewport](/maps/documentation/geocoding/reference/rest/v4beta/Viewport)`)` A viewport suitable for displaying the geocode result. |\n| `bounds` | `object (`[Viewport](/maps/documentation/geocoding/reference/rest/v4beta/Viewport)`)` A bounding box for the address. |\n| `formattedAddress` | `string` The one line formatted address. |\n| `postalAddress` | `object (`[PostalAddress](/maps/documentation/geocoding/reference/rest/Shared.Types/PostalAddress)`)` The address in postal address format. |\n| `addressComponents[]` | `object (`[GeocodeResult.AddressComponent](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult#GeocodeResult.AddressComponent)`)` Repeated components for each locality level. |\n| `postalCodeLocalities[]` | `object (`[LocalizedText](/maps/documentation/geocoding/reference/rest/Shared.Types/LocalizedText)`)` Complete list of localities contained in the postal code. This is only populated when the result is of type \"postal_code\". |\n| `types[]` | `string` A set of type tags for this result. For example, \"political\" and \"administrative_area\". For the complete list of possible values, see Table A and Table B at \u003chttps://developers.google.com/maps/documentation/places/web-service/place-types\u003e. |\n| `plusCode` | `object (`[PlusCode](/maps/documentation/geocoding/reference/rest/v4beta/PlusCode)`)` Plus code of the location in this geocode. |\n\nGeocodeResult.AddressComponent\n------------------------------\n\nThe structured components that form the formatted address, if this information is available.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------|\n| ``` { \"longText\": string, \"shortText\": string, \"types\": [ string ], \"languageCode\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `longText` | `string` The full text description or name of the address component. For example, an address component for the country Australia may have a long name of \"Australia\". |\n| `shortText` | `string` An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short name of \"AU\". |\n| `types[]` | `string` An array indicating the type(s) of the address component. See \u003chttps://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types\u003e for more details. |\n| `languageCode` | `string` The language used to format this components, in CLDR notation. |"]]