- طلب HTTP
- نص الطلب
- نص الاستجابة
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- التبرير
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
البحث عن الأماكن استنادًا إلى طلبات البحث النصية
طلب HTTP
POST https://places.googleapis.com/v1/places:searchText
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
الحقول | |
---|---|
textQuery |
مطلوبة. طلب البحث النصي للبحث النصي. |
languageCode |
سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا كان رمز اللغة غير محدّد أو غير معروف، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفّر هذه التفاصيل. القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام. |
rankPreference |
كيفية ترتيب النتائج في الردّ |
includedType |
نوع المكان المطلوب. القائمة الكاملة للأنواع المتوافقة: https://developers.google.com/maps/documentation/places/web-service/place-types. يجب استخدام نوع واحد مضمّن فقط. |
openNow |
يُستخدم لحصر البحث على الأماكن المفتوحة حاليًا. والقيمة التلقائية هي false. |
minRating |
يمكنك تصفية النتائج التي يقل متوسط تقييم المستخدمين فيها عن هذا الحدّ الأقصى تمامًا. يجب أن تكون القيمة الصالحة عائمة بين 0 و5 (بشكل شامل) بوتيرة 0.5، أي [0، 0.5، 1.0، ... ، 5.0] بشكل شامل. سيتم تقريب تقييم الإدخال إلى أقرب 0.5(سقف). على سبيل المثال، سيؤدي التقييم 0.6 إلى إزالة جميع النتائج ذات التقييم الأقل من 1.0. |
maxResultCount |
مهملة: يمكنك استخدام تمثّل هذه السمة الحد الأقصى لعدد النتائج التي يمكن عرضها لكل صفحة. إذا كان عدد النتائج المتاحة أكبر من إذا تم تحديد كل من |
pageSize |
اختياريّ. تمثّل هذه السمة الحد الأقصى لعدد النتائج التي يمكن عرضها لكل صفحة. إذا كان عدد النتائج المتاحة أكبر من إذا تم تحديد كل من |
pageToken |
اختياريّ. رمز مميز للصفحة تم استلامه من مكالمة سابقة عبر TextSearch. يُرجى توفير هذا الحقل لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات بخلاف |
priceLevels[] |
يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. يمكن للمستخدمين اختيار أي مجموعات من مستويات الأسعار. اختيار جميع مستويات السعر تلقائيًا |
strictTypeFiltering |
يُستخدَم لضبط فلترة الأنواع الصارمة لـincludeType. إذا تم ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط. يكون الإعداد التلقائي بالقيمة "خطأ". |
locationBias |
المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين. لا يمكن الضبط مع locationRestriction. |
locationRestriction |
المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي. لا يمكن الضبط مع locationBias. |
evOptions |
اختياريّ. ضبط خيارات المركبة الكهربائية القابلة للبحث لطلب البحث عن مكان |
نص الاستجابة
نموذج الرد لـ places.searchText.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "places": [ { object ( |
الحقول | |
---|---|
places[] |
قائمة بالأماكن التي تستوفي معايير البحث النصي للمستخدِم. |
contextualContents[] |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. قائمة بالمحتوى السياقي حيث يرتبط كل إدخال بالمكان المقابل في الفهرس نفسه في حقل الأماكن. يُفضَّل استخدام المحتوى ذي الصلة بـ |
nextPageToken |
هو رمز يمكن إرساله كـ |
RankPreference
كيفية ترتيب النتائج في الردّ
عمليات التعداد | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
بالنسبة إلى استعلام فئوي مثل "مطاعم في مدينة نيويورك"، يكون RELEVANCE الافتراضي هو. بالنسبة إلى طلبات البحث غير الفئوية، مثل "Mountain View, CA"، ننصحك بترك المفضلة بدون ضبط. |
DISTANCE |
يعمل على ترتيب النتائج حسب المسافة. |
RELEVANCE |
يعمل على ترتيب النتائج حسب مدى صلتها بموضوع البحث. يتم تحديد ترتيب الترتيب حسب مكدّس الترتيب العادي. |
LocationBias
المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
rectangle |
مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة |
circle |
دائرة محددة بواسطة نقطة المركز ونصف القطر. |
LocationRestriction
المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
rectangle |
مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة |
EVOptions
خيارات يمكن البحث عنها للمركبة الكهربائية لطلب البحث عن مكان
تمثيل JSON |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
الحقول | |
---|---|
minimumChargingRateKw |
اختياريّ. الحد الأدنى لمعدل الشحن المطلوب بالكيلوواط تتم فلترة المكان الذي يكون معدّل الشحن أقل من المعدّل المحدّد. |
connectorTypes[] |
اختياريّ. قائمة بأنواع موصِّلات المركبات الكهربائية المفضّلة يتم استبعاد المكان الذي لا يتيح أيًا من أنواع الموصلات المدرجة. |
ContextualContent
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.
المحتوى المرتبط بطلب البحث عن المكان
تمثيل JSON |
---|
{ "reviews": [ { object ( |
الحقول | |
---|---|
reviews[] |
قائمة بالمراجعات حول هذا المكان باستثناء طلب البحث عن المكان |
photos[] |
معلومات (بما في ذلك المراجع) حول صور هذا المكان، بجانب طلب البحث عن المكان |
justifications[] |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. مبرّرات المكان. |
السبب
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.
مبرّرات المكان. تجيب المبررات عن السؤال حول السبب الذي قد يجعل المكان مهمًا للمستخدم النهائي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
reviewJustification |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. |
businessAvailabilityAttributesJustification |
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. |
ReviewJustification
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل.
مبرّرات مراجعة المستخدِم. يبرز هذا قسم مراجعة المستخدم الذي قد يهم المستخدم النهائي. على سبيل المثال، إذا كان طلب البحث هو "بيتزا حطب"، يُبرز تبرير المراجعة النص ذي الصلة بطلب البحث.
تمثيل JSON |
---|
{ "highlightedText": { object ( |
الحقول | |
---|---|
highlightedText |
|
review |
المراجعة التي تم إنشاء النص المميّز منها. |
HighlightedText
تمثّل هذه السمة النص الذي تم تمييزه من خلال التبرير. هذه مجموعة فرعية من المراجعة نفسها. يتم تمييز الكلمة نفسها التي يجب تمييزها باستخدام MarkedTextRange. قد يكون هناك عدة كلمات في النص الذي يتم تمييزه.
تمثيل JSON |
---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
الحقول | |
---|---|
text |
|
highlightedTextRanges[] |
تمثّل هذه السمة نطاقات النص المميّز. |
HighlightedTextRange
نطاق النص المميّز.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer } |
الحقول | |
---|---|
startIndex |
|
endIndex |
|
BusinessAvailabilityAttributesJustification
ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative لمزيد من التفاصيل. مبرّرات BusinessAvailabilityAttributes. يوضح هذا بعض السمات في النشاط التجاري والتي قد تهم المستخدم النهائي.
تمثيل JSON |
---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
الحقول | |
---|---|
takeout |
إذا كان المكان يقدّم الطعام السفري |
delivery |
توفّر خدمة توصيل الطلبات في مكان معيّن |
dineIn |
إذا كان المكان يوفّر خدمة تناول الطعام داخل المطعم |