Geocoder

فئة Geocoder

google.maps.Geocoder صف
مكتبة "geocoding"

خدمة للتحويل بين عنوان وLatLng.

const {Geocoder} = await google.maps.importLibrary("geocoding");

واجهة GeocoderRequest

واجهة google.maps.GeocoderRequest

يشير هذا الحقل إلى مواصفات طلب الترميز الجغرافي الذي سيتم إرساله إلى Geocoder.

الخصائص
address اختياري	النوع: string optional العنوان المطلوب ترميزه جغرافيًا يجب تقديم سمة واحدة فقط من السمات التالية: address وlocation وplaceId.
bounds اختياري	النوع: LatLngBounds|LatLngBoundsLiteral optional LatLngBounds المطلوب البحث فيه اختيارية:
componentRestrictions اختياري	النوع: GeocoderComponentRestrictions optional تُستخدَم المكوّنات لحصر النتائج في منطقة معيّنة. يتكوّن الفلتر من عنصر واحد أو أكثر من العناصر التالية: route وlocality وadministrativeArea وpostalCode وcountry. سيتم عرض النتائج التي تطابق جميع الفلاتر فقط. تتيح قيم الفلاتر استخدام الطرق نفسها لتصحيح الأخطاء الإملائية والمطابقة الجزئية مثل طلبات الترميز الجغرافي الأخرى. اختيارية:
extraComputations اختياري	النوع: Array<ExtraGeocodeComputation> optional قائمة بالعمليات الحسابية الإضافية التي يمكن استخدامها لإكمال الطلب ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ.
fulfillOnZeroResults اختياري	النوع: boolean optional يتم تنفيذ الوعد في حالة ZERO_RESULT في الردّ. قد يكون ذلك مطلوبًا لأنّه حتى في حال عدم توفّر نتائج ترميز جغرافي، قد يتم عرض حقول إضافية على مستوى الاستجابة.
language اختياري	النوع: string optional معرّف اللغة التي يجب عرض النتائج بها، إن أمكن ذلك. اطّلِع على قائمة اللغات المتاحة.
location اختياري	النوع: LatLng|LatLngLiteral optional LatLng (أو LatLngLiteral) المطلوب البحث عنه تنفّذ أداة الترميز الجغرافي عملية عكس الترميز الجغرافي. لمزيد من المعلومات، يُرجى الاطّلاع على عكس الترميز الجغرافي. يجب تقديم سمة واحدة فقط من السمات التالية: address وlocation وplaceId.
placeId اختياري	النوع: string optional رقم تعريف المكان المرتبط بالموقع الجغرافي تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّري Places API تنفّذ أداة الترميز الجغرافي عملية عكس الترميز الجغرافي. لمزيد من المعلومات، يُرجى الاطّلاع على عكس الترميز الجغرافي. يجب تقديم سمة واحدة فقط من السمات التالية: address وlocation وplaceId.
region اختياري	النوع: string optional رمز البلد المستخدَم لتوجيه البحث، ويتم تحديده كعلامة فرعية لمنطقة Unicode مكوّنة من حرفَين (غير رقمي) أو معرّف CLDR. اختيارية: يُرجى الاطّلاع على تفاصيل تغطية "منصة خرائط Google" لمعرفة المناطق المعتمدة.

واجهة GeocoderComponentRestrictions

واجهة google.maps.GeocoderComponentRestrictions

يمثّل GeocoderComponentRestrictions مجموعة من الفلاتر التي تؤدي إلى منطقة معيّنة. لمعرفة التفاصيل حول آلية عمل ذلك، يُرجى الاطّلاع على فلترة مكوّنات الترميز الجغرافي.

ثوابت ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation ثوابت
مكتبة "geocoding"

عمليات حسابية إضافية يتم إجراؤها أثناء إكمال طلب الترميز الجغرافي

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ExtraGeocodeComputationString.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

ثوابت GeocoderStatus

google.maps.GeocoderStatus ثوابت
مكتبة "geocoding"

الحالة التي تعرضها السمة Geocoder عند اكتمال طلب إلى geocode(). حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.GeocoderStatus.OK.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع GeocoderStatusString.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

واجهة GeocoderResponse

واجهة google.maps.GeocoderResponse

استجابة Geocoder التي يعرضها Geocoder والتي تحتوي على قائمة GeocoderResult.

الخصائص
results	النوع: Array<GeocoderResult> قائمة GeocoderResult.
address_descriptor اختياري	النوع: AddressDescriptor optional وصف نسبي لموقع جغرافي تتضمّن مجموعة مرتبة من المعالم القريبة والمناطق التي تحتوي على الموقع الجغرافي المستهدف. ولا تتم تعبئته إلا لطلبات عكس الترميز الجغرافي وعند تفعيل ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فقط.
plus_code اختياري	النوع: PlacePlusCode optional رمز Plus Code المرتبط بالموقع الجغرافي

واجهة GeocoderResult

واجهة google.maps.GeocoderResult

نتيجة واحدة لأداة الترميز الجغرافي تم استردادها من خادم الترميز الجغرافي قد يعرض طلب الترميز الجغرافي عناصر نتائج متعدّدة. يُرجى العِلم أنّه على الرغم من أنّ هذه النتيجة "تشبه JSON"، فهي ليست JSON بشكل صارم، لأنّها تتضمّن بشكل غير مباشر كائن LatLng.

الخصائص
address_components	النوع: Array<GeocoderAddressComponent> مصفوفة من GeocoderAddressComponent
formatted_address	النوع: string سلسلة تحتوي على عنوان هذا الموقع الجغرافي ويمكن لشخص عادي قراءتها
geometry	النوع: GeocoderGeometry عنصر GeocoderGeometry
place_id	النوع: string رقم تعريف المكان المرتبط بالموقع الجغرافي تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّري Places API
types	النوع: Array<string> مصفوفة من السلاسل التي تشير إلى نوع عنصر الترميز الجغرافي الذي تم عرضه. للاطّلاع على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع مكوّنات العناوين في دليل المطوّر.
address_descriptor اختياري	النوع: AddressDescriptor optional وصف نسبي للموقع الجغرافي المرتبط بهذا الرمز الجغرافي تتضمّن مجموعة مرتبة من المعالم القريبة والمناطق التي تحتوي على الموقع الجغرافي المستهدف. لن تتم تعبئة هذا الحقل إلا لطلبات الترميز الجغرافي الأمامي والبحث عن رقم تعريف المكان، وفقط عندما يكون ExtraGeocodeComputation.ADDRESS_DESCRIPTORS مفعَّلاً، وفقط لأماكن معيّنة تم ترجمتها.
partial_match اختياري	النوع: boolean optional ما إذا كانت أداة الترميز الجغرافي لم تعرض مطابقة تامة للطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. في حال المطابقة التامة، ستكون القيمة undefined.
plus_code اختياري	النوع: PlacePlusCode optional رمز Plus Codes المرتبط بالموقع الجغرافي
postcode_localities اختياري	النوع: Array<string> optional مصفوفة من السلاسل التي تشير إلى جميع المناطق المشمولة في رمز بريدي معيّن لا تظهر هذه السمة إلا عندما تكون النتيجة رمزًا بريديًا يحتوي على عدة مناطق محلية.

واجهة AddressDescriptor

واجهة google.maps.AddressDescriptor

وصف نسبي لموقع جغرافي تتضمّن مجموعة مرتبة من المعالم القريبة والمناطق التي تحتوي على الموقع الجغرافي المستهدف.

واجهة GeocoderAddressComponent

واجهة google.maps.GeocoderAddressComponent

مكوّن عنوان واحد ضمن GeocoderResult. قد يتألف العنوان الكامل من عدة مكوّنات.

واجهة GeocoderGeometry

واجهة google.maps.GeocoderGeometry

معلومات هندسية حول GeocoderResult

ثوابت GeocoderLocationType

google.maps.GeocoderLocationType ثوابت
مكتبة "geocoding"

يصف نوع الموقع الجغرافي الذي تم عرضه من ترميز جغرافي. حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'ROOFTOP' أو google.maps.GeocoderLocationType.ROOFTOP.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع GeocoderLocationTypeString.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

واجهة Landmark

واجهة google.maps.Landmark

مكان يمثّل نقطة مرجعية للعنوان

واجهة Area

واجهة google.maps.Area

مكان يمثّل منطقة صغيرة، مثل حي أو منطقة فرعية أو مجمّع كبير يحتوي على الموقع الجغرافي المستهدف.

ثوابت الاحتواء

google.maps.Containment ثوابت
مكتبة "geocoding"

قائمة تعداد تمثّل العلاقة المكانية بين المنطقة والموقع الجغرافي المستهدَف.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ContainmentString.

const {Containment} = await google.maps.importLibrary("geocoding");

ثوابت SpatialRelationship

google.maps.SpatialRelationship ثوابت
مكتبة "geocoding"

قائمة تعداد تمثّل العلاقة في المساحة بين المَعلم والهدف

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع SpatialRelationshipString.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");