Geocoder

فئة Geocoder

google.maps.Geocoder صف

خدمة للتحويل بين عنوان وموقع جغرافي (LatLng).

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

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

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

واجهة GeocoderRequest

google.maps.GeocoderRequest interface

يشير هذا الحقل إلى مواصفات طلب الترميز الجغرافي الذي سيتم إرساله إلى 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 interface

يمثّل 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 constants

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

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

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

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

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

ثوابت 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 interface

استجابة Geocoder تم إرجاعها بواسطة 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 interface

نتيجة ترميز جغرافي واحدة تم استردادها من خادم الترميز الجغرافي. قد يعرض طلب الرمز الجغرافي عناصر نتائج متعددة. يُرجى العِلم أنّه على الرغم من أنّ هذه النتيجة "تشبه 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 interface

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

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

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

واجهة GeocoderAddressComponent

google.maps.GeocoderAddressComponent interface

تمثّل هذه السمة مكوّن عنوان واحدًا ضمن GeocoderResult. قد يتألف العنوان الكامل من عدة عناصر.

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

واجهة GeocoderGeometry

google.maps.GeocoderGeometry interface

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

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

google.maps.Landmark interface

ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي 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 interface

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

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

ثوابت SpatialRelationship

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

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

تعداد يمثّل العلاقة المكانية بين المعلم والهدف.

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

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