Geocoder

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Geocoder} = await google.map.importLibrary("geocoding"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
Geocoder
Geocoder()
المعلّمات: بدون
لإنشاء مثيل جديد من Geocoder يرسل طلبات الترميز الجغرافي إلى خوادم Google.
geocode
geocode(request[, callback])
المعلّمات:
قيمة الإرجاع: 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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {GeocoderStatus} = await google.map.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
مصفوفة من 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
نوع الموقع الجغرافي المعروض في location
viewport
النوع: LatLngBounds
حدود إطار العرض الموصى به لعرض GeocoderResult هذا
bounds optional
النوع: LatLngBounds optional
الحدود الدقيقة لـ GeocoderResult، إن أمكن

ثوابت GeocoderLocationType

google.maps.GeocoderLocationType ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {GeocoderLocationType} = await google.map.importLibrary("geocoding"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
APPROXIMATE والنتيجة المعروضة تقريبية.
GEOMETRIC_CENTER وتكون النتيجة المعروضة هي المركز الهندسي لنتيجة مثل هذا الخط (مثل الشارع) أو المضلع (المنطقة).
RANGE_INTERPOLATED تعكس النتيجة المعروضة تقريبيًا (عادةً على طريق) بين نقطتين دقيقتين (مثل التقاطعات). يتم عرض النتائج المضافة بشكل عام عندما تكون الرموز الجغرافية للأسطح غير متاحة لعنوان الشارع.
ROOFTOP تعرض النتيجة المعروضة رمزًا جغرافيًا دقيقًا.