Geocoder

فئة المشفِّر الجغرافي

google.maps.Geocoder class

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Geocoder} = await google.maps.importLibrary("geocoding"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
Geocoder	Geocoder() المَعلمات:  بدون تُنشئ هذه الوظيفة نسخة جديدة من Geocoder تُرسِل طلبات الرموز الجغرافية إلى خوادم Google.

الطُرق
geocode	geocode(request[, callback]) المَعلمات:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional القيمة المعروضة:  Promise<GeocoderResponse> ترميز طلب جغرافيًا

واجهة GeocoderRequest

google.maps.GeocoderRequest واجهة

مواصفات طلب ترميز جغرافي لإرساله إلى Geocoder

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

واجهة 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
ERROR	حدثت مشكلة أثناء الاتصال بخوادم Google.
INVALID_REQUEST	GeocoderRequest غير صالح.
OK	يحتوي الردّ على GeocoderResponse صالح.
OVER_QUERY_LIMIT	تجاوزت صفحة الويب الحدّ الأقصى للطلبات في فترة زمنية قصيرة جدًا.
REQUEST_DENIED	لا يُسمح لصفحة الويب باستخدام أداة ترميز المواقع الجغرافية.
UNKNOWN_ERROR	تعذّرت معالجة طلب ترميز جغرافي بسبب خطأ في الخادم. قد ينجح الطلب إذا حاولت مرة أخرى.
ZERO_RESULTS	لم يتم العثور على أي نتيجة لهذا GeocoderRequest.

واجهة GeocoderResponse

google.maps.GeocoderResponse واجهة

استجابة "محوِّل الرموز الجغرافية" التي يعرضها Geocoder والتي تحتوي على قائمة GeocoderResult

الخصائص
results	النوع:  Array<GeocoderResult> قائمة GeocoderResult

واجهة 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> صفيف من السلاسل يشير إلى نوع العنصر الذي تم ترميزه جغرافيًا والمعروض. للحصول على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع مكونات العنوان في دليل المطوّر.
partial_match optional	النوع:  boolean optional ما إذا كان محوِّل الترميز الجغرافي لم يعرِض مطابقة دقيقة للطلب الأصلي، على الرغم من أنّه تمكّن من مطابقة جزء من العنوان المطلوب في حال المطابقة التامة، ستكون القيمة undefined.
plus_code optional	النوع:  PlacePlusCode optional رمز Plus Codes المرتبط بالموقع الجغرافي
postcode_localities optional	النوع:  Array<string> optional صفيف من السلاسل يشير إلى جميع المواقع الجغرافية الواردة في الرمز البريدي لا يظهر هذا الحقل إلا عندما تكون النتيجة رمزًا بريديًا يحتوي على عدة مناطق محلية.

واجهة GeocoderAddressComponent

google.maps.GeocoderAddressComponent واجهة

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

الخصائص
long_name	النوع:  string النص الكامل لمكوّن العنوان
short_name	النوع:  string النص المختصر لمكوّن العنوان المحدّد
types	النوع:  Array<string> مصفوفة من السلاسل التي تشير إلى نوع مكوّن العنوان هذا يمكن العثور على قائمة بالأنواع الصالحة هنا.

واجهة GeocoderGeometry

google.maps.GeocoderGeometry واجهة

معلومات الأشكال الهندسية حول هذا GeocoderResult

الخصائص
location	النوع:  LatLng إحداثيات خط العرض/خط الطول لهذه النتيجة
location_type	النوع:  GeocoderLocationType نوع الموقع الجغرافي الذي تم إرجاعه في location
viewport	النوع:  LatLngBounds حدود إطار العرض المقترَح لعرض هذا GeocoderResult
bounds optional	النوع:  LatLngBounds optional الحدود الدقيقة لهذا GeocoderResult، إذا كان ذلك منطبقًا

GeocoderLocationType الثوابت

google.maps.GeocoderLocationType الثوابت

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
APPROXIMATE	تكون النتيجة المعروضة تقريبية.
GEOMETRIC_CENTER	النتيجة المعروضة هي المركز الهندسي لنتيجة مثل خط (مثل شارع) أو مضلع (منطقة).
RANGE_INTERPOLATED	تعكس النتيجة المعروضة قيمة تقريبية (عادةً على طريق) تمّت إضافتها بين نقطتَين دقيقتَين (مثل التقاطعات). يتم بشكل عام عرض النتائج التي تمّت الاستقراء فيها عندما لا تتوفّر رموز جغرافية لسطح المنزل لعنوان شارع معيّن.
ROOFTOP	تعكس النتيجة المعروضة رمزًا جغرافيًا دقيقًا.