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

استجابة برنامج ترميز جغرافي يعرضها Geocoder ويحتوي على قائمة GeocoderResult.
results
النوع:  Array<GeocoderResult>
قائمة GeocoderResults.
Betaaddress_descriptor optional
النوع:  AddressDescriptor optional
وصف علائقي لموقع. تتضمن مجموعة مرتَّبة من المعالم المجاورة والمناطق التي تحتوي على الموقع الجغرافي المستهدف. وتتم تعبئة هذا الحقل فقط لطلبات الترميز الجغرافي العكسي وفقط عند تفعيل "ExtraGeocodeComputation.ADDRESS_DESCRIPTORS".
plus_code optional
النوع:  PlacePlusCode optional
رمز Plus Codes المرتبط بالموقع الجغرافي.

واجهة 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>
مصفوفة من السلاسل تشير إلى نوع العنصر الذي تم عرضه جغرافيًا. للحصول على قائمة بالسلاسل المحتملة، يُرجى الرجوع إلى قسم أنواع مكونات العناوين في دليل المطوّر.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
APPROXIMATE والنتيجة التي يتم عرضها تقريبية.
GEOMETRIC_CENTER والنتيجة المعروضة هي المركز الهندسي للنتيجة لخط (مثل شارع) أو مضلّع (منطقة).
RANGE_INTERPOLATED تعكس النتيجة المعروضة تقديرًا تقريبيًا (في طريق ما عادة) بين نقطتين دقيقتين (مثل التقاطعات). بشكل عام، يتم عرض النتائج المُدخلة عندما لا تكون الرموز الجغرافية للأسطح غير متوفرة لعنوان الشارع.
ROOFTOP تعكس النتيجة التي يتم عرضها ترميزًا جغرافيًا دقيقًا.

واجهة Landmark

واجهة 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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
NEAR الموقع الجغرافي المستهدف خارج المنطقة، ولكنّه على مقربة منك.
OUTSKIRTS يقع الموقع الجغرافي المستهدَف داخل المنطقة، على مقربة من الحافة.
WITHIN يقع الموقع الجغرافي المستهدَف داخل المنطقة المعنيّة، بالقرب من وسط المدينة.

ثابت SpatialRelationship

google.maps.SpatialRelationship ثابت

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

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