Geocoder

برنامج ترميز المواقع الجغرافية

google.maps.Geocoder الصف الدراسي

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

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

الشركة المصنِّعة
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. تعرف على المزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّر برامج واجهة برمجة تطبيقات الأماكن. ينفِّذ أداة الترميز جغرافيًا عكسيًا. راجع عكس الترميز الجغرافي للاطلاع على مزيد من المعلومات. يجب تقديم عنصر واحد فقط من address وlocation وplaceId.
region optional	النوع:  string optional رمز البلد المُستخدَم لانحياز البحث المحدَّد كعلامة فرعية لمنطقة Unicode مكوّنة من حرفين (غير رقمي) / معرّف CLDR. اختياريّ. راجع تفاصيل تغطية Google Maps Platform للمناطق المدعومة.

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

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

GeocoderResponse واجهة

واجهة google.maps.GeocoderResponse

عرض استجابة أداة الترميز الجغرافي من خلال Geocoder التي تحتوي على قائمة GeocoderResults.

أماكن إقامة
results	النوع:  Array<GeocoderResult> قائمة GeocoderResults

واجهة GeocoderResult

واجهة google.maps.GeocoderResult

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

أماكن إقامة
address_components	النوع:  Array<GeocoderAddressComponent> مصفوفة من GeocoderAddressComponent
formatted_address	النوع:  string سلسلة تحتوي على عنوان سهل القراءة للمستخدم لهذا الموقع.
geometry	النوع:  GeocoderGeometry عنصر GeocoderGeometry
place_id	النوع:  string رقم تعريف المكان المقترن بالموقع. تحدد معرّفات الأماكن بشكل فريد مكانًا في قاعدة بيانات أماكن Google وفي خرائط Google. تعرف على المزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّر برامج واجهة برمجة تطبيقات الأماكن.
types	النوع:  Array<string> مصفوفة من السلاسل تدل على نوع العنصر الذي تم ترميزه جغرافيًا والذي تم عرضه. للحصول على قائمة بالسلاسل المحتملة، راجع قسم أنواع مكوّنات العنوان في دليل مطوّري البرامج.
partial_match optional	النوع:  boolean optional تحدّد هذه السمة ما إذا كان برنامج الترميز الجغرافي لم يعرض مطابقة تامة للطلب الأصلي، على الرغم من أنه تمكن من مطابقة جزء من العنوان المطلوب. في حال المطابقة التامة، ستكون القيمة undefined.
plus_code optional	النوع:  PlacePlusCode optional رمز الموقع المفتوح المرتبط بالموقع الجغرافي.
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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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