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. ولن يتم عرض سوى النتائج التي تتطابق مع جميع الفلاتر. تتيح قيم الفلاتر طرق تصحيح الأخطاء الإملائية والمطابقة الجزئية نفسها المستخدَمة في طلبات ترميز المواقع الجغرافية الأخرى. اختيارية:
extraComputations optional	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع:  Array<ExtraGeocodeComputation> optional قائمة بعمليات حسابية إضافية يمكن استخدامها لإكمال الطلب ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الاستجابة.
fulfillOnZeroResults optional	النوع:  boolean optional يجب الوفاء بالوعد بحالة ZERO_RESULT في الردّ. قد يكون هذا مطلوبًا لأنّه حتى في حال عدم توفّر أي نتائج ترميز جغرافي، قد يستمر عرض حقول إضافية على مستوى الردّ.
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 اختيارية:

ExtraGeocodeComputation الثوابت

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

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

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

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

الثوابت
ADDRESS_DESCRIPTORS	أنشئ وصفًا للعنوان.

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
address_descriptor optional	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع:  AddressDescriptor optional وصف علائقي لموقع جغرافي يتضمّن مجموعة مصنّفة من المعالم المجاورة والمناطق التي تحتوي على الموقع الجغرافي المستهدَف. ولا تتم تعبئته إلا لطلبات الترميز الجغرافي العكسي وعند تفعيل ExtraGeocodeComputation.ADDRESS_DESCRIPTORS فقط.
plus_code optional	النوع:  PlacePlusCode optional رمز Plus Codes المرتبط بالموقع الجغرافي

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

واجهة AddressDescriptor

google.maps.AddressDescriptor واجهة

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

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

الخصائص
areas	النوع:  Array<Area> قائمة مصنّفة بالمناطق التي تحتوي على النقطة أو المجاورة لها يتم ترتيب المناطق الأكثر فائدة (المعروفة والدقيقة) أولاً.
landmarks	النوع:  Array<Landmark> قائمة مصنّفة بالمعالم القريبة يتم ترتيب المعالم الأكثر فائدة (المعروفة والقريبة) أولاً.

واجهة 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	تعكس النتيجة المعروضة رمزًا جغرافيًا دقيقًا.

واجهة المَعلم

google.maps.Landmark واجهة

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

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

الخصائص
display_name	النوع:  string اسم المَعلم
display_name_language_code	النوع:  string لغة اسم المَعلم
place_id	النوع:  string معرّف المكان للمنشأة الأساسية التي تشكّل المَعلم يمكن استخدامها لعرض المزيد من المعلومات عن المَعلم من خلال "تفاصيل المكان" أو "البحث عن رقم تعريف المكان".
spatial_relationship	النوع:  SpatialRelationship يحدِّد ذلك العلاقة المكانية بين الموقع المستهدف والمعلم.
straight_line_distance_meters	النوع:  number المسافة المستقيمة بين الموقع الجغرافي المستهدَف والمعلم
types	النوع:  Array<string> قيمة واحدة أو أكثر تشير إلى نوع النتيجة المعروضة يُرجى الاطّلاع على الأنواع لمعرفة مزيد من التفاصيل.
travel_distance_meters optional	النوع:  number optional المسافة التي يتم قطعها على طول شبكة الطرق بين الموقع الجغرافي المستهدَف والمعلم يمكن عدم تعبئة هذا الحقل إذا كان المَعلم غير متصل بجزء من شبكة الطرق الأقرب إلى الهدف أو إذا لم يكن الموقع الجغرافي المستهدَف يقع على شبكة الطرق.

واجهة المنطقة

google.maps.Area واجهة

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

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

الخصائص
containment	النوع:  Containment يحدِّد العلاقة المكانية بين الموقع الجغرافي المستهدَف والمنطقة.
display_name	النوع:  string اسم المنطقة
display_name_language_code	النوع:  string لغة اسم المنطقة
place_id	النوع:  string رقم تعريف المكان للمنطقة الأساسية يمكن استخدامها لعرض المزيد من المعلومات عن المنطقة من خلال "تفاصيل المكان" أو "البحث عن رقم تعريف المكان".

ثوابت الحاويات

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

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

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

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

الثوابت
NEAR	الموقع الجغرافي المستهدَف خارج منطقة البحث، ولكنه قريب.
OUTSKIRTS	الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من الحافة.
WITHIN	الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من المركز.

SpatialRelationship الثوابت

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

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

عنصر مصنّف يمثّل العلاقة في الفضاء بين المَعلمة والهدف

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

الثوابت
ACROSS_THE_ROAD	الهدف يقع مباشرةً مقابل المَعلم على الجانب الآخر من الطريق.
AROUND_THE_CORNER	ليست على المسار نفسه الذي يمر به المَعلم، ولكن يمكن الوصول إليها من خلال منعطف واحد.
BEHIND	قريب من بنية المَعلم ولكنّه أبعد من نقطة الوصول إليه
BESIDE	الهدف مجاور مباشرةً للمعلم.
DOWN_THE_ROAD	على المسار نفسه الذي يمر به المَعلم، ولكن ليس بجانبه أو على الجانب المقابل
NEAR	هذه هي العلاقة التلقائية عندما لا ينطبق أيّ من الأنواع أدناه.
WITHIN	يمتلك المَعلم شكلاً هندسيًا مكانيًا والهدف يقع ضمن حدوده.