Geocoder

فئة برنامج الترميز الجغرافي

صف واحد (google.maps.Geocoder)

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

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

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. اطّلع على مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّري واجهة 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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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>
قائمة GeocoderResults.

واجهة GeocoderResult

واجهة google.maps.GeocoderResult

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

address_components
مصفوفة من GeocoderAddressComponents
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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