Geocoder

فئة 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 interface

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

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

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

واجهة GeocoderResult

google.maps.GeocoderResult interface

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

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

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

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