Geocoder

فئة المشفِّر الجغرافي

google.maps.Geocoder class

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Geocoder} = await google.maps.importLibrary("geocoding"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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. ولن يتم عرض سوى النتائج التي تتطابق مع جميع الفلاتر. تتيح قيم الفلاتر طرق تصحيح الأخطاء الإملائية والمطابقة الجزئية نفسها المستخدَمة في طلبات ترميز المواقع الجغرافية الأخرى. اختيارية:
BetaextraComputations optional
النوع:  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 الثوابت

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

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

واجهة GeocoderResult

google.maps.GeocoderResult واجهة

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

وصف علائقي لموقع جغرافي يتضمّن مجموعة مصنّفة من المعالم المجاورة والمناطق التي تحتوي على الموقع الجغرافي المستهدَف.
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 واجهة

مكان يمثّل نقطة مرجعية للعنوان
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 واجهة

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

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

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {Containment} = await google.maps.importLibrary("geocoding"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
NEAR الموقع الجغرافي المستهدَف خارج منطقة البحث، ولكنه قريب.
OUTSKIRTS الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من الحافة.
WITHIN الموقع الجغرافي المستهدَف يقع ضمن منطقة المنطقة، بالقرب من المركز.

SpatialRelationship الثوابت

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ACROSS_THE_ROAD الهدف يقع مباشرةً مقابل المَعلم على الجانب الآخر من الطريق.
AROUND_THE_CORNER ليست على المسار نفسه الذي يمر به المَعلم، ولكن يمكن الوصول إليها من خلال منعطف واحد.
BEHIND قريب من بنية المَعلم ولكنّه أبعد من نقطة الوصول إليه
BESIDE الهدف مجاور مباشرةً للمعلم.
DOWN_THE_ROAD على المسار نفسه الذي يمر به المَعلم، ولكن ليس بجانبه أو على الجانب المقابل
NEAR هذه هي العلاقة التلقائية عندما لا ينطبق أيّ من الأنواع أدناه.
WITHIN يمتلك المَعلم شكلاً هندسيًا مكانيًا والهدف يقع ضمن حدوده.