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". يمكنك الاطّلاع على مزيد من المعلومات حول