برنامج ترميز المواقع الجغرافية
google.maps.Geocoder
الصف الدراسي
خدمة للتحويل بين العنوان وLatLng
.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {Geocoder} = await google.map.importLibrary("geocoding")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
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 . ولن يتم عرض سوى النتائج التي تتطابق مع جميع الفلاتر. تدعم قيم الفلاتر الطرق نفسها للتصحيح الإملائي والمطابقة الجزئية لطلبات الترميز الجغرافي الأخرى. اختياريّ. |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض النتائج بها، إن أمكن. راجع قائمة اللغات المدعومة. |
location optional |
النوع:
LatLng|LatLngLiteral optional LatLng (أو LatLngLiteral ) للبحث عنها. ينفِّذ أداة الترميز جغرافيًا عكسيًا. راجع عكس الترميز الجغرافي للاطلاع على مزيد من المعلومات. يجب تقديم عنصر واحد فقط من address وlocation وplaceId . |
placeId optional |
النوع:
string optional رقم تعريف المكان المقترن بالموقع. تحدد معرّفات الأماكن بشكل فريد مكانًا في قاعدة بيانات أماكن Google وفي خرائط Google. تعرف على المزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّر برامج واجهة برمجة تطبيقات الأماكن. ينفِّذ أداة الترميز جغرافيًا عكسيًا. راجع عكس الترميز الجغرافي للاطلاع على مزيد من المعلومات. يجب تقديم عنصر واحد فقط من address وlocation وplaceId . |
region optional |
النوع:
string optional رمز البلد المُستخدَم لانحياز البحث المحدَّد كعلامة فرعية لمنطقة Unicode مكوّنة من حرفين (غير رقمي) / معرّف CLDR. اختياريّ. راجع تفاصيل تغطية Google Maps Platform للمناطق المدعومة. |
واجهة 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 . اختياريّ. |
ثوابت GeocoderStatus
google.maps.GeocoderStatus
ثوابت
الحالة التي تم عرضها بواسطة Geocoder
عند إكمال مكالمة إلى geocode()
. حدد هذه القيم بحسب القيمة أو باستخدام اسم الثوابت. على سبيل المثال، 'OK'
أو google.maps.GeocoderStatus.OK
.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {GeocoderStatus} = await google.map.importLibrary("geocoding")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
ERROR |
حدثت مشكلة أثناء الاتصال بخوادم Google. |
INVALID_REQUEST |
GeocoderRequest غير صالح. |
OK |
تحتوي الاستجابة على سمة GeocoderResponse صالحة. |
OVER_QUERY_LIMIT |
تجاوزت صفحة الويب حد الطلبات في فترة زمنية قصيرة جدًا. |
REQUEST_DENIED |
لا يُسمح لصفحة الويب باستخدام أداة الترميز الجغرافي. |
UNKNOWN_ERROR |
تعذرت معالجة طلب الترميز الجغرافي بسبب خطأ في الخادم. قد ينجح الطلب في حال إعادة المحاولة. |
ZERO_RESULTS |
لم يتم العثور على نتائج لهذا GeocoderRequest . |
GeocoderResponse واجهة
واجهة
google.maps.GeocoderResponse
عرض استجابة أداة الترميز الجغرافي من خلال Geocoder
التي تحتوي على قائمة GeocoderResult
s.
أماكن إقامة | |
---|---|
results |
النوع:
Array<GeocoderResult> قائمة GeocoderResult s |
واجهة GeocoderResult
واجهة
google.maps.GeocoderResult
نتيجة واحدة للترميز الجغرافي تم استردادها من خادم الترميز الجغرافي. قد يعرض طلب الترميز الجغرافي كائنات نتائج متعددة. يُرجى العِلم بأنه على الرغم من أنّ هذه النتيجة "تشبه JSON"، إلّا أنّها لا تتضمّن JSON بشكل صارم، لأنّها تتضمّن كائن LatLng
بشكل غير مباشر.
أماكن إقامة | |
---|---|
address_components |
النوع:
Array<GeocoderAddressComponent> مصفوفة من GeocoderAddressComponent |
formatted_address |
النوع:
string سلسلة تحتوي على عنوان سهل القراءة للمستخدم لهذا الموقع. |
geometry |
النوع:
GeocoderGeometry عنصر GeocoderGeometry |
place_id |
النوع:
string رقم تعريف المكان المقترن بالموقع. تحدد معرّفات الأماكن بشكل فريد مكانًا في قاعدة بيانات أماكن Google وفي خرائط Google. تعرف على المزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوّر برامج واجهة برمجة تطبيقات الأماكن. |
types |
النوع:
Array<string> مصفوفة من السلاسل تدل على نوع العنصر الذي تم ترميزه جغرافيًا والذي تم عرضه. للحصول على قائمة بالسلاسل المحتملة، راجع قسم أنواع مكوّنات العنوان في دليل مطوّري البرامج. |
partial_match optional |
النوع:
boolean optional تحدّد هذه السمة ما إذا كان برنامج الترميز الجغرافي لم يعرض مطابقة تامة للطلب الأصلي، على الرغم من أنه تمكن من مطابقة جزء من العنوان المطلوب. في حال المطابقة التامة، ستكون القيمة undefined . |
plus_code optional |
النوع:
PlacePlusCode optional رمز الموقع المفتوح المرتبط بالموقع الجغرافي. |
postcode_localities optional |
النوع:
Array<string> optional مصفوفة من السلاسل تدل على جميع المناطق المحلية المتضمنة في رمز بريدي. لا يتوفر هذا إلا إذا كانت النتيجة عبارة عن رمز بريدي يحتوي على العديد من المناطق المحلية. |
واجهة 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
.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {GeocoderLocationType} = await google.map.importLibrary("geocoding")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
APPROXIMATE |
والنتيجة المعروضة تقريبية. |
GEOMETRIC_CENTER |
وتكون النتيجة المعروضة هي المركز الهندسي لنتيجة مثل هذا الخط (مثل الشارع) أو المضلع (المنطقة). |
RANGE_INTERPOLATED |
تعكس النتيجة المعروضة تقريبيًا (عادةً على طريق) بين نقطتين دقيقتين (مثل التقاطعات). يتم عرض النتائج المضافة بشكل عام عندما تكون الرموز الجغرافية للأسطح غير متاحة لعنوان الشارع. |
ROOFTOP |
تعرض النتيجة المعروضة رمزًا جغرافيًا دقيقًا. |