مرجع الأدوات

كل الأدوات الـ42، مع كل معامل وقيمة افتراضية وقيد ومثال. تتوفر الواجهة نفسها عبر MCP وCLI.

قواعد الاستدعاء

الأمثلة كائنات معاملات MCP. لاستدعاء MCP خام بصيغة tools/call، ضع اسم الأداة في name والكائن في arguments. قد يضيف المضيف بادئة للأسماء. تستخدم استدعاءات CLI المكافئة أدناه mcp-gmap-rs call TOOL --args JSON.

لمعاملات المستوى الأعلى فقط خيارات CLI. مرّر الكائنات المتداخلة والمصفوفات بصيغة JSON. يعني الخيار المنطقي المجرد true؛ ويضبط --flag false القيمة false. تُرفض الخصائص غير المعروفة. افحص الإصدار المثبت باستخدام tools أو schema TOOL.

مصادقة Google واللغة إعدادات للعملية، وليستا معاملات أداة. تتجنب الإحداثيات الدقيقة حل العناوين؛ وقد تتطلب المواقع المسماة مفتاح API لـ Geocoding أيضًا. راجع المصادقة والإعدادات.

قد تترتب رسوم Google على الاستدعاءات. قد تتضمن نتائج الأدوات المركبة والمصفوفات أخطاء لكل عنصر حتى مع نجاح الأداة. احتفظ بروابط Google وأسماء مؤلفي المراجعات والصور وإفصاحات ملخصات الذكاء الاصطناعي. توضح الأمثلة المدخلات، لا التغطية أو النتائج الحالية.

تأتي الأنواع والحقول المطلوبة وحدود المخطط من المرجع المشتق من مخططات الملف التنفيذي. تُراجع القيم الافتراضية وأوصاف النتائج والقيود بين الحقول مقابل التنفيذ. قد تفرض Google حدود تغطية وحصص إضافية.

تُرفض الخصائص غير المعروفة في المستوى الأعلى؛ تقبل أجسام API الأصلية حقول Google التي تتحقق Google من صحتها. لا تُعاد محاولات عمليات التعديل تلقائيًا.

الأدوات

maps_geocode
maps_validate_address
maps_pollen
maps_area_insights
maps_snap_to_roads
maps_nearest_roads
maps_reverse_geocode
maps_search_places
maps_search_nearby
maps_place_details
maps_directions
maps_distance_matrix
maps_elevation
maps_timezone
maps_weather
maps_air_quality
maps_static_map
maps_batch_geocode
maps_explore_area
maps_plan_route
maps_compare_places
maps_search_along_route
maps_local_rank_tracker
maps_speed_limits
maps_autocomplete
maps_geolocate
maps_solar
maps_aerial_view
maps_render_aerial_video
maps_map_tiles
maps_streetview
maps_streetview_publish
maps_datasets
maps_route_optimization
maps_air_quality_forecast
maps_air_quality_history
maps_air_quality_heatmap
maps_pollen_heatmap
maps_weather_history
maps_weather_alerts
maps_weather_minute_forecast
maps_weather_map

maps_geocode

تحويل عنوان أو معلم إلى إحداثيات.

حل عنوان أو معلم إلى أول تطابق Geocoding للحصول على إحداثيات قابلة لإعادة الاستخدام ومعرّف مكان؛ ولا يتحقق ذلك من قابلية التسليم البريدي.

أمر CLI: geocode. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`address` / `--address`	نص; على الأقل 1 محرف	نعم	—	العنوان أو المدينة أو المعلم المراد ترميزه جغرافيًا.

السلوك والقيود

عدم العثور على تطابق خطأ أداة، وليس موقعًا فارغًا ناجحًا.
تستخدم هذه الأداة المباشرة Geocoding v3 ؛ ويُستخدم بديل Places في الأدوات المركبة التي تحل المواقع، وليس في هذا الاستدعاء.

النتيجة

كائن يتضمن location.lat وlocation.lng وformatted_address وplace_id. تُعاد النتيجة الأولى فقط.

مثال

معاملات MCP:

json

{
  "address": "Eiffel Tower, Paris, France"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_geocode --args '{"address":"Eiffel Tower, Paris, France"}'

maps_validate_address

التحقق من عنوان بريدي وتوحيده؛ يعيد حكم Google وتصحيحاته ومكوناته وترميزه الجغرافي. الحكم دليل وليس ضمان توصيل.

تحقق من مكونات البريد وأعد التصحيحات والعنوان الموحّد وحكم Google. أبقِ الحكم والمكونات غير المحسومة ظاهرين للمستدعي.

أمر CLI: validate-address. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`addressLines` / `--address-lines`	مصفوفة نصوص; `1–10` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	سطر عنوان بريدي واحد أو أكثر بالترتيب.
`administrativeArea` / `--administrative-area`	نص; على الأقل 1 محرف	لا	غير مزوّد	الولاية أو المقاطعة أو الوحدة الإدارية المقابلة.
`enableUspsCass` / `--enable-usps-cass`	منطقي	لا	false	طلب معالجة USPS CASS؛ يتطلب هذا التنفيذ أن يكون regionCode بقيمة US أو PR عند true.
`locality` / `--locality`	نص; على الأقل 1 محرف	لا	غير مزوّد	المدينة أو البلدة.
`postalCode` / `--postal-code`	نص; على الأقل 1 محرف	لا	غير مزوّد	الرمز البريدي أو ZIP.
`regionCode` / `--region-code`	نص; النمط: `^[A-Z]{2}$`	لا	غير مزوّد؛ قد تستنتجه Google	رمز بلد أو منطقة من حرفين كبيرين؛ يوصى به لتمييز العنوان.
`sessionToken` / `--session-token`	نص; على الأقل 1 محرف	لا	بلا تجميع جلسات؛ فوترة كل طلب	رمز آمن لعناوين URL ينشئه المستدعي، حتى 36 حرف ASCII؛ يُنصح بـ UUID v4 جديد لكل جلسة. أرسل الرمز نفسه إلى Place Details أو Address Validation الختامي.

السلوك والقيود

حكم التحقق ليس ضمان توصيل.
تختلف التغطية الإقليمية وتغطية API. لا ترسل هذه الأداة ملاحظات تحقق ولا تقبل التصحيحات تلقائيًا.

النتيجة

استجابة التحقق الكاملة، وتتضمن عادة result.verdict وresult.address وresult.geocode وresponseId؛ وقد تحذف Google الحقول غير المتاحة.

مثال

معاملات MCP:

json

{
  "addressLines": [
    "5 Avenue Anatole France"
  ],
  "regionCode": "FR",
  "locality": "Paris",
  "postalCode": "75007"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_validate_address --args '{"addressLines":["5 Avenue Anatole France"],"regionCode":"FR","locality":"Paris","postalCode":"75007"}'

maps_pollen

جلب توقعات حبوب اللقاح ومؤشراتها والتوصيات الصحية لـ 1–5 أيام لإحداثيات دقيقة. تختلف التغطية بحسب الموقع والموسم.

استرجاع توقع يومي قصير لحبوب اللقاح لإحداثيات دقيقة. تحافظ الاستجابة على الأنواع والمؤشرات ومعلومات النباتات وتوصيات المزوّد.

أمر CLI: pollen. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`days` / `--days`	عدد صحيح; `1–5`	لا	1	عدد سجلات التوقع اليومي المطلوب.
`latitude` / `--latitude`	رقم; `-90.0–90.0`	نعم	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	نعم	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`plantsDescription` / `--plants-description`	منطقي	لا	false	تضمين أوصاف النباتات المفصلة والمعلومات المرتبطة عند توفرها.

السلوك والقيود

تستخدم الطلبات حجم صفحة 5 ، وهو كافٍ للحد الأقصى وهو خمسة أيام؛ ولا تُجلب صفحات إضافية تلقائيًا.
تعتمد الإتاحة على الموقع والموسم وتغطية Google.

النتيجة

استجابة Pollen الأصلية، بما فيها regionCode وdailyInfo وأي nextPageToken. قد يتضمن كل يوم معلومات أنواع حبوب اللقاح والنباتات.

مثال

معاملات MCP:

json

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "days": 3,
  "plantsDescription": false
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_pollen --args '{"latitude":48.8584,"longitude":2.2945,"days":3,"plantsDescription":false}'

maps_area_insights

عدّ الأماكن ضمن دائرة أو منطقة أو مضلع باستخدام Places Aggregate. تتوفر معرّفات اختيارية عند عدد 100 أو أقل فقط؛ ولا تُطلب التفاصيل تلقائيًا.

عدّ الأماكن المطابقة في دائرة أو منطقة أو مضلع عبر Places Aggregate. هذا استعلام تجميعي، وليس عدّ صفحة بحث Places محدودة.

أمر CLI: area-insights. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`area` / `--area`	كائن	نعم	—	واحد فقط من circle أو region أو customArea.
`area.circle`	كائن	لا	غير مزوّد	منطقة دائرية؛ لا تجتمع مع region أو customArea.
`area.circle.latLng`	كائن	عند توفير الكائن الأب	—	مركز الدائرة كإحداثيات دقيقة.
`area.circle.latLng.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`area.circle.latLng.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`area.circle.radius`	عدد صحيح; `23–50000`	عند توفير الكائن الأب	—	نصف قطر الدائرة بالأمتار.
`area.customArea`	كائن	لا	غير مزوّد	منطقة مضلع مخصص؛ لا تجتمع مع circle أو region.
`area.customArea.polygon`	كائن	عند توفير الكائن الأب	—	حد المضلع.
`area.customArea.polygon.coordinates`	مصفوفة كائنات; `4–1000` عناصر	عند توفير الكائن الأب	—	حلقة مرتبة من كائنات الإحداثيات؛ يجب تطابق أول إحداثية وآخرها.
`area.customArea.polygon.coordinates[].latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`area.customArea.polygon.coordinates[].longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`area.region`	كائن	لا	غير مزوّد	منطقة إدارية أو جغرافية يحددها مورد مكان Google.
`area.region.place`	نص; النمط: `^places/[A-Za-z0-9_-]+$`	عند توفير الكائن الأب	—	مورد المنطقة بصيغة places/PLACE_ID، وليس اسم منطقة نصيًا حرًا.
`excludedTypes` / `--excluded-types`	مصفوفة نصوص; `1–50` عناصر; كل عنصر لا يقل عن 1 محرف	لا	دون مرشح أنواع مستبعدة	أنواع أماكن Google المراد استبعادها.
`includePlaces` / `--include-places`	منطقي	لا	false	طلب معرّفات موارد الأماكن المطابقة إضافة إلى العدد.
`includedTypes` / `--included-types`	مصفوفة نصوص; `1–50` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	أنواع أماكن Google المراد تضمينها، مثل restaurant أو cafe.
`maxRating` / `--max-rating`	رقم; `1.0–5.0`	لا	دون حد أعلى للتقييم	حد أعلى شامل للتقييم.
`minRating` / `--min-rating`	رقم; `1.0–5.0`	لا	دون حد أدنى للتقييم	حد أدنى شامل للتقييم؛ لا يمكن أن يتجاوز maxRating.
`operatingStatus` / `--operating-status`	مصفوفة نصوص; `1–3` عناصر; القيم: `OPERATING_STATUS_OPERATIONAL`, `OPERATING_STATUS_PERMANENTLY_CLOSED`, `OPERATING_STATUS_TEMPORARILY_CLOSED`	لا	تفترض Google الأماكن العاملة	حالات التشغيل المسموحة.
`priceLevels` / `--price-levels`	مصفوفة نصوص; `1–5` عناصر; القيم: `PRICE_LEVEL_FREE`, `PRICE_LEVEL_INEXPENSIVE`, `PRICE_LEVEL_MODERATE`, `PRICE_LEVEL_EXPENSIVE`, `PRICE_LEVEL_VERY_EXPENSIVE`	لا	كل مستويات الأسعار	مستويات الأسعار المسموحة.

السلوك والقيود

وفّر شكل منطقة واحدًا بالضبط. الكائنات المتداخلة قيم JSON في CLI؛ وليس لمعاملاتها الفرعية خيارات مستقلة.
يجب إغلاق حلقات المضلع. تفحص Google أيضًا هندسة المضلع والأنواع المدعومة والمساحة والتغطية.
تتوفر معرّفات الأماكن فقط عند عدد 100 أو أقل. لا تطلب الأداة Place Details تلقائيًا.

النتيجة

استجابة Google مع count (عادة نص int64) وموارد placeInsights[].place الاختيارية عند طلب المعرّفات وتوفرها.

مثال

معاملات MCP:

json

{
  "area": {
    "circle": {
      "latLng": {
        "latitude": 48.8584,
        "longitude": 2.2945
      },
      "radius": 500
    }
  },
  "includedTypes": [
    "restaurant"
  ],
  "minRating": 4
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_area_insights --args '{"area":{"circle":{"latLng":{"latitude":48.8584,"longitude":2.2945},"radius":500}},"includedTypes":["restaurant"],"minRating":4}'

maps_snap_to_roads

مطابقة مسار GPS مرتب من 2–100 نقطة بالطرق. اجعل النقاط المتتالية ضمن نحو 300 متر لنتائج جيدة. يضيف الاستيفاء الاختياري هندسة الطريق.

مطابقة تتبع GPS مرتب بهندسة الطريق الأرجح. استخدم Nearest Roads للنقاط المستقلة بدل مسار سفر.

أمر CLI: snap-to-roads. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`interpolate` / `--interpolate`	منطقي	لا	false	إضافة هندسة الطريق الوسيطة بين النقاط المزوّدة.
`path` / `--path`	مصفوفة كائنات; `2–100` عناصر	نعم	—	كائنات إحداثيات GPS بحسب ترتيب السفر.
`path[].latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`path[].longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

ينبغي أن تكون نقاط الإدخال المتتالية ضمن نحو 300 متر لمطابقة جيدة.
قد لا تحتوي النقاط المستوفاة على originalIndex. لا تطلب هذه الأداة حدود السرعة.

النتيجة

استجابة Roads الأصلية بما فيها snappedPoints وأي warningMessage. تحافظ النقاط على placeId وlocation وoriginalIndex عند توفرها.

مثال

معاملات MCP:

json

{
  "path": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ],
  "interpolate": true
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_snap_to_roads --args '{"path":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}],"interpolate":true}'

maps_nearest_roads

العثور على أقرب مقاطع طرق لـ 1–100 نقطة GPS مستقلة؛ يحافظ على originalIndex ومعرّفات طرق Google.

العثور على مقاطع طرق قرب نقاط GPS مستقلة دون تفسيرها كتتبع واحد متصل.

أمر CLI: nearest-roads. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`points` / `--points`	مصفوفة كائنات; `1–100` عناصر	نعم	—	كائنات إحداثيات مستقلة للمطابقة.
`points[].latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`points[].longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

قد تطابق النقطة أكثر من مقطع طريق واحد؛ احتفظ بـ originalIndex بدل افتراض نتيجة واحدة لكل مدخل.
لا تطلب هذه الأداة حدود السرعة.

النتيجة

استجابة Roads الأصلية مع snappedPoints وplaceId للطريق وlocation وoriginalIndex الذي يربط النتيجة بنقاط الإدخال.

مثال

معاملات MCP:

json

{
  "points": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ]
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_nearest_roads --args '{"points":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}]}'

maps_reverse_geocode

تحويل الإحداثيات إلى عنوان شارع.

تحويل إحداثيات دقيقة إلى أول نتيجة Geocoding عكسية. استخدم مكونات النتيجة عندما لا يكفي العنوان المنسق وحده.

أمر CLI: reverse-geocode. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`latitude` / `--latitude`	رقم; `-90.0–90.0`	نعم	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	نعم	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

تُعاد النتيجة الأولى فقط. عدم التطابق خطأ أداة.

النتيجة

أول نتيجة Geocoding أصلية، بما فيها formatted_address وaddress_components وgeometry وplace_id عند توفرها.

مثال

معاملات MCP:

json

{
  "latitude": 48.8584,
  "longitude": 2.2945
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_reverse_geocode --args '{"latitude":48.8584,"longitude":2.2945}'

maps_search_places

بحث نصي في Places (New) مع مرشحات اختيارية للموقع والتقييم.

البحث في Places (New) بالنص ومرشحات موقع وتقييم ونوع اختيارية. استخدم المعرّفات المُعادة لطلبات تفاصيل انتقائية.

أمر CLI: search-places. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`includedType` / `--included-type`	نص; على الأقل 1 محرف	لا	دون مرشح نوع	نوع مكان Google، مثل cafe.
`locationBias` / `--location-bias`	كائن	لا	دون انحياز موقع	انحياز بحث دائري اختياري؛ الانحياز ليس قيدًا جغرافيًا صارمًا.
`locationBias.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`locationBias.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`locationBias.radius`	رقم; `0.1–50000.0`	لا	5000	نصف قطر الانحياز بالأمتار.
`minRating` / `--min-rating`	رقم; `0.0–5.0`	لا	دون مرشح تقييم	الحد الأدنى لتقييم المستخدم المطلوب من Google.
`openNow` / `--open-now`	منطقي	لا	دون قيد حالة الفتح	الحصر في الأماكن المفتوحة حاليًا عند true.
`query` / `--query`	نص; على الأقل 1 محرف	نعم	—	استعلام مكان باللغة الطبيعية.

السلوك والقيود

تطلب الأداة صفحة واحدة من 20 نتيجة ولا تعيد رمز صفحة ولا تتبعه تلقائيًا.
يعتمد غياب بيانات الفتح والتقييم على تغطية Google؛ لا تستنتج جردًا شاملًا من هذا البحث.

النتيجة

مصفوفة تصل إلى 20 كائن Google Place مع حقول بحث مختارة وروابط Maps والمصدر وبيانات النسب.

مثال

معاملات MCP:

json

{
  "query": "coffee near Gare de Lyon, Paris",
  "openNow": true,
  "minRating": 4
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_search_places --args '{"query":"coffee near Gare de Lyon, Paris","openNow":true,"minRating":4}'

maps_search_nearby

العثور على أماكن حول عنوان أو إحداثيات دقيقة، مع تصفية النوع والتقييم وحالة الفتح.

العثور على أماكن داخل نصف قطر محدد حول مركز محلول. خلافًا للبحث النصي، يستخدم قيد موقع دائريًا صارمًا.

أمر CLI: search-nearby. الوصول إلى Google: تقبل Places مفتاح API أو OAuth. تحتاج مراكز العناوين والمعالم أيضًا مفتاح API للتحويل عبر Geocoding.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`center` / `--center`	كائن	نعم	—	مدخل المركز والمؤشر الذي يصف طريقة تفسيره.
`center.isCoordinates`	منطقي	لا	false	معاملة value كإحداثيات دقيقة دون ترميز جغرافي.
`center.value`	نص; على الأقل 1 محرف	عند توفير الكائن الأب	—	عنوان أو معلم، أو نص latitude,longitude عندما يكون isCoordinates بالقيمة true.
`keyword` / `--keyword`	نص; على الأقل 1 محرف	لا	دون مرشح نوع	نوع مكان Google يُمرر كـ includedTypes، مثل cafe؛ وليس كلمة بحث نصية حرة.
`minRating` / `--min-rating`	رقم; `0.0–5.0`	لا	دون مرشح تقييم	الحد الأدنى للتقييم الذي يطبّق محليًا على الأماكن المُعادة.
`openNow` / `--open-now`	منطقي	لا	false	إبقاء النتائج التي يكون currentOpeningHours.openNow فيها true فقط.
`radius` / `--radius`	رقم; `0.1–50000.0`	لا	1000	نصف قطر البحث بالأمتار.

السلوك والقيود

عند التصفية، لا تُحسب حالة الفتح المفقودة مفتوحة ويُعامل التقييم المفقود كـ 0.
تحتاج مراكز العناوين إلى حل الموقع؛ وتتجنب الإحداثيات ذلك الاستدعاء الإضافي.

النتيجة

مصفوفة تصل إلى 20 كائن Place مختار. قد تقلص مرشحات الفتح والتقييم المحلية المصفوفة أكثر.

مثال

معاملات MCP:

json

{
  "center": {
    "value": "48.8584,2.2945",
    "isCoordinates": true
  },
  "keyword": "cafe",
  "radius": 500
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_search_nearby --args '{"center":{"value":"48.8584,2.2945","isCoordinates":true},"keyword":"cafe","radius":500}'

maps_place_details

جلب تفاصيل المكان والمراجعات والنسب. تحافظ روابط الصور الاختيارية على نسب المؤلف. اعرض بيانات المصدر والإفصاح بجانب المحتوى.

توسيع معرّف مكان معروف إلى تفاصيل مختارة ومراجعات وروابط صور اختيارية. احتفظ بالمؤلف والمصدر وأي نص إفصاح للذكاء الاصطناعي.

أمر CLI: place-details. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`maxPhotos` / `--max-photos`	عدد صحيح; `0–10`	لا	0	الحد الأقصى لعمليات جلب روابط وسائط الصور.
`placeId` / `--place-id`	نص; على الأقل 1 محرف	نعم	—	معرّف مكان Google، مع بادئة places/ اختياريًا.
`sessionToken` / `--session-token`	نص; على الأقل 1 محرف	لا	بلا تجميع جلسات؛ فوترة كل طلب	رمز آمن لعناوين URL ينشئه المستدعي، حتى 36 حرف ASCII؛ يُنصح بـ UUID v4 جديد لكل جلسة. أرسل الرمز نفسه إلى Place Details أو Address Validation الختامي.

السلوك والقيود

قد تنتج كل صورة مختارة طلبًا إضافيًا؛ ويمنع صفر صور هذه الاستدعاءات.
تستخدم الأداة قناع حقول ثابتًا للتفاصيل، لا كل حقول Google Place الممكنة. قد تغيب الحقول غير المتاحة.

النتيجة

كائن Google Place أصلي لقناع الحقول المطلوب. عند طلب الصور، يحمل photoUrls روابط الوسائط ونسب مؤلفي الصور وروابط المصادر.

مثال

معاملات MCP:

json

{
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "maxPhotos": 1
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_place_details --args '{"placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","maxPhotos":1}'

maps_directions

جلب الاتجاهات وهندسة المسار وتعليمات الملاحة ومدة التنقل.

حساب مسار بين نقطتي نهاية وعرض بيانات مسار Google المختارة والإجماليات الموحّدة.

أمر CLI: directions. الوصول إلى Google: تقبل Routes وPlaces مفتاح API أو OAuth. يحتاج حل أسماء المواقع أيضًا مفتاح API لـ Geocoding؛ وتتجنب نصوص الإحداثيات الدقيقة ذلك البحث.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`arrival_time` / `--arrival-time`	نص; على الأقل 1 محرف	لا	غير مزوّد	الوصول المرغوب بصيغة RFC 3339 مع منطقة زمنية؛ للنقل العام فقط.
`avoid_highways` / `--avoid-highways`	منطقي	لا	false	تجنب الطرق السريعة؛ تُدعم true للقيادة فقط.
`avoid_tolls` / `--avoid-tolls`	منطقي	لا	false	تجنب طرق الرسوم؛ تُدعم true للقيادة فقط.
`departure_time` / `--departure-time`	نص; على الأقل 1 محرف	لا	غير مزوّد	لحظة المغادرة بصيغة RFC 3339 مع Z أو إزاحة UTC صريحة.
`destination` / `--destination`	نص; على الأقل 1 محرف	نعم	—	عنوان أو معلم الوجهة أو نص latitude,longitude دقيق.
`mode` / `--mode`	نص; القيم: `driving`, `walking`, `bicycling`, `transit`	لا	driving	وسيلة التنقل. تستخدم القيادة توجيهًا يراعي حركة المرور.
`origin` / `--origin`	نص; على الأقل 1 محرف	نعم	—	عنوان أو معلم البداية أو نص latitude,longitude دقيق.
`polylineQuality` / `--polyline-quality`	نص; القيم: `OVERVIEW`, `HIGH_QUALITY`	لا	HIGH_QUALITY عندما trafficSegments=true؛ وإلا تستخدم Google القيمة الافتراضية OVERVIEW	جودة الهندسة: OVERVIEW أو HIGH_QUALITY. يتقدم الاختيار الصريح دائمًا، بما فيه OVERVIEW مع trafficSegments=true. يتحكم بكثافة النقاط بصورة مستقلة عن حسابات حركة المرور.
`trafficSegments` / `--traffic-segments`	منطقي	لا	false	خيار منطقي اختياري للقيادة فقط. يطلب TRAFFIC_ON_POLYLINE بهندسة ENCODED_POLYLINE؛ ويستخدم HIGH_QUALITY افتراضيًا ما لم تحدد polylineQuality صراحةً. تفعّل حركة المرور على الخطوط تسعير Compute Routes Enterprise الأعلى تكلفة؛ اتركه false إذا لم تحتج تفاصيل المقاطع.

السلوك والقيود

لا يمكن توفير departure_time وarrival_time معًا. يُقبل arrival_time للنقل العام فقط.
تتطلب خيارات التجنب وضع القيادة. تفرض Google قيودًا إضافية بحسب الوسيلة والوقت والمنطقة.
عدم وجود مسار متاح خطأ صريح.
عند trafficSegments=true يعيد Routes فترات NORMAL أو SLOW أو TRAFFIC_JAM. تستخدم المقاطع الموحّدة لكل مسار أو جزء خطه الخاص وفهارس نقاط مستقلة. فترات Google هي [start,end)؛ وتحتفظ هندسة المقطع برأس الحدود النهائي المشترك لتغطية الحافة الأخيرة. يُبلّغ عن التغطية المفقودة أو غير الصالحة بوضوح، ولا تُختلق حركة مرور عادية.
يمثل segmentMetadata.retrievedAt وقت جلب الاستجابة محليًا، وليس وقت رصد حركة المرور لدى المزود؛ تكون trafficObservedAt بقيمة null لأن Routes لا يعيدها. وتكون roadCategory وspeedLimit بقيمة null لأن استجابة Routes هذه لا توفرهما. لا تحدث استدعاءات ضمنية إلى Roads ولا تُطبّق معاملات محلية على المدة؛ تظل المدد توقعات Google.
مقاطع حركة المرور اختيارية وتقتصر على القيادة في هذا البرنامج. يطلب الخيار خطوطًا تتضمن حركة المرور ويُفعّل فوترة Compute Routes Enterprise. مواصفات الفترات؛ شروط تفعيل بنود التسعير الحالية.
تختار polylineQuality تفاصيل الهندسة التي تعيدها Google: تستخدم HIGH_QUALITY نقاطًا أكثر، وتزيد حجم الاستجابة وقد تزيد زمن الانتظار. يبقى اختيار OVERVIEW صراحةً صالحًا مع trafficSegments=true. عند إغفال الجودة تستخدم مقاطع المرور HIGH_QUALITY؛ وإلا تستخدم Google القيمة OVERVIEW. لا يصطنع البرنامج تفاصيل إضافية ولا يضيفها بالاستيفاء بين النقاط. الجودة مستقلة عن extraComputations؛ واختيار HIGH_QUALITY وحده لا يفعّل TRAFFIC_ON_POLYLINE. التعريف الرسمي لـ PolylineQuality.

المصادر الأصلية: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

النتيجة

كائن يحتوي routes وsummary وtotal_distance (بالأمتار) وtotal_duration (بالثواني) وفهارس تحسين اختيارية. تتضمن المسارات مقاطع وخطوات وخطًا مشفرًا وتحذيرات مختارة. عند trafficSegments=true، تتضمن المسارات والأجزاء أيضًا segments موحّدة وsegmentMetadata.

مثال

معاملات MCP:

json

{
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_directions --args '{"origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking"}'

maps_distance_matrix

حساب مسافات التنقل ومدده لعدة نقاط بداية ووجهات.

مقارنة مسافة ومدة التنقل لكل زوج بداية ووجهة. افحص الخلايا والأخطاء منفردة بدل اعتبار الاستجابة الناجحة مكتملة.

أمر CLI: distance-matrix. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`avoid_highways` / `--avoid-highways`	منطقي	لا	false	تجنب الطرق السريعة؛ تُدعم true للقيادة فقط.
`avoid_tolls` / `--avoid-tolls`	منطقي	لا	false	تجنب طرق الرسوم؛ تُدعم true للقيادة فقط.
`departure_time` / `--departure-time`	نص; على الأقل 1 محرف	لا	غير مزوّد	لحظة المغادرة بصيغة RFC 3339 مع Z أو إزاحة UTC صريحة.
`destinations` / `--destinations`	مصفوفة نصوص; `1–50` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	نصوص الوجهات: عناوين أو أزواج latitude,longitude دقيقة.
`mode` / `--mode`	نص; القيم: `driving`, `walking`, `bicycling`, `transit`	لا	driving	وسيلة التنقل. تستخدم القيادة توجيهًا يراعي حركة المرور.
`origins` / `--origins`	مصفوفة نصوص; `1–50` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	نصوص البداية: عناوين أو أزواج latitude,longitude دقيقة.

السلوك والقيود

625 زوج بداية × وجهة كحد أقصى؛ ويُحد النقل العام بـ 100 زوج.
50 نص بداية أو وجهة غير إحداثي كحد أقصى إجمالًا. لا تلغي حدود المخطط لكل مصفوفة هذه الحدود المشتركة.
ينطبق تجنب الرسوم والطرق السريعة على القيادة فقط. لا تعرض هذه الأداة arrival_time.
قد يُفوَّتر طلب HTTP واحد للمصفوفة كعدة عناصر.

النتيجة

كائن يتضمن origin_addresses وdestination_addresses ومصفوفتي distances وdurations بترتيب الصفوف ومصفوفة errors. قيم الخلايا الناجحة بالأمتار والثواني؛ وتبقى الخلايا الفاشلة أو المفقودة null.

مثال

معاملات MCP:

json

{
  "origins": [
    "48.8584,2.2945"
  ],
  "destinations": [
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_distance_matrix --args '{"origins":["48.8584,2.2945"],"destinations":["48.8606,2.3376","48.8530,2.3499"],"mode":"walking"}'

maps_elevation

جلب الارتفاع بالأمتار لإحداثيات جغرافية.

جلب الارتفاع الجغرافي لنقاط إحداثيات دقيقة.

أمر CLI: elevation. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`locations` / `--locations`	مصفوفة كائنات; `1–512` عناصر	نعم	—	كائنات الإحداثيات المطلوب ارتفاعها.
`locations[].latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`locations[].longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

تعيد الأداة بيانات Google المبلغ عنها دون تحويل وحدات الارتفاع.

النتيجة

مصفوفة Elevation الأصلية results. قد تتضمن العناصر elevation بالأمتار وlocation وresolution.

مثال

معاملات MCP:

json

{
  "locations": [
    {
      "latitude": 48.8584,
      "longitude": 2.2945
    }
  ]
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_elevation --args '{"locations":[{"latitude":48.8584,"longitude":2.2945}]}'

maps_timezone

جلب المنطقة الزمنية وإزاحات UTC والتوقيت الصيفي والوقت المحلي. timestamp بمللي ثانية Unix.

حل هوية المنطقة الزمنية وإزاحات UTC والتوقيت الصيفي في لحظة، ثم اشتقاق طابع زمني محلي.

أمر CLI: timezone. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`latitude` / `--latitude`	رقم; `-90.0–90.0`	نعم	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	نعم	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`timestamp` / `--timestamp`	عدد صحيح; `0–253402300799999`	لا	وقت UTC الحالي بالمللي ثانية	مللي ثانية منذ بدء Unix، وليست ثواني.

السلوك والقيود

يحوّل الطلب المللي ثانية إلى ثوانٍ كاملة؛ ولا تُحفظ دقة أجزاء الثانية.
يستخدم الوقت المحلي الإزاحة الأساسية وإزاحة التوقيت الصيفي المُعادتين للحظة المطلوبة.

النتيجة

حقول المنطقة الزمنية مثل timeZoneId وtimeZoneName وrawOffset وdstOffset بالثواني، إضافة إلى localTime مشتق بصيغة RFC 3339.

مثال

معاملات MCP:

json

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "timestamp": 1793448000000
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_timezone --args '{"latitude":48.8584,"longitude":2.2945,"timestamp":1793448000000}'

maps_weather

جلب الطقس الحالي أو التوقعات اليومية أو الساعية.

طلب الظروف الحالية أو صفحة واحدة من التوقعات اليومية أو الساعية لإحداثيات دقيقة.

أمر CLI: weather. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`forecastDays` / `--forecast-days`	عدد صحيح; `1–10`	لا	5	عدد أيام التوقع المطلوب؛ يُستخدم مع forecast_daily فقط.
`forecastHours` / `--forecast-hours`	عدد صحيح; `1–240`	لا	24	عدد ساعات التوقع المطلوب؛ يُستخدم مع forecast_hourly فقط.
`latitude` / `--latitude`	رقم; `-90.0–90.0`	نعم	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	نعم	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`type` / `--type`	نص; القيم: `current`, `forecast_daily`, `forecast_hourly`	لا	current	اختيار الظروف الحالية أو التوقع اليومي أو الساعي.

السلوك والقيود

يُتجاهل forecastDays للأنواع الأخرى؛ ويُتجاهل forecastHours خارج forecast_hourly.
لا تتبع الأداة رموز الصفحات تلقائيًا. قد تتجاوز الفترة المطلوبة السجلات الموجودة في صفحة استجابة واحدة.
تعتمد التغطية وإتاحة التوقعات على Google.

النتيجة

استجابة Weather الأصلية: حقول الظروف الحالية أو forecastDays أو forecastHours بحسب النوع. احتفظ بالوحدات والطوابع الزمنية وأي nextPageToken.

مثال

معاملات MCP:

json

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "type": "forecast_daily",
  "forecastDays": 3
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_weather --args '{"latitude":48.8584,"longitude":2.2945,"type":"forecast_daily","forecastDays":3}'

maps_air_quality

جلب مؤشرات جودة الهواء وتركيزات ملوثات اختيارية وتوصيات صحية.

جلب مؤشرات جودة الهواء الحالية مع تركيزات ملوثات وتوصيات صحية من المزوّد اختياريًا.

أمر CLI: air-quality. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`includeHealthRecommendations` / `--include-health-recommendations`	منطقي	لا	true	طلب حساب توصيات Google الصحية.
`includePollutants` / `--include-pollutants`	منطقي	لا	false	طلب تركيزات الملوثات.
`latitude` / `--latitude`	رقم; `-90.0–90.0`	نعم	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	نعم	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

التوصيات بيانات من المزوّد، وليست تقييمًا طبيًا شخصيًا.
تعرض الأداة الظروف الحالية، وليس نقاط نهاية تاريخية أو توقعات.

النتيجة

استجابة Air Quality الأصلية للظروف الحالية، بما فيها المؤشرات وhealthRecommendations وpollutants اختياريًا عندما توفرها Google.

مثال

معاملات MCP:

json

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "includePollutants": true
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_air_quality --args '{"latitude":48.8584,"longitude":2.2945,"includePollutants":true}'

maps_static_map

جلب خريطة PNG بعلامات ومسارات. يعيد MCP صورة مضمنة؛ ويعيد CLI بصيغة base64 JSON أو يكتب --output.

رسم خريطة PNG مع علامات ومواصفات مسارات اختيارية.

أمر CLI: static-map. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`center` / `--center`	نص; على الأقل 1 محرف	لا	غير مزوّد	المركز كعنوان أو نص latitude,longitude.
`maptype` / `--maptype`	نص; القيم: `roadmap`, `satellite`, `terrain`, `hybrid`	لا	roadmap	نمط الخريطة الأساسية.
`markers` / `--markers`	مصفوفة نصوص; `1–100` عناصر; كل عنصر لا يقل عن 1 محرف	لا	دون علامات	مواصفات علامات Google Static Maps المتكررة، مثل color:red\|48.8584,2.2945.
`path` / `--path`	مصفوفة نصوص; `1–100` عناصر; كل عنصر لا يقل عن 1 محرف	لا	دون مسارات	مواصفات مسارات Google Static Maps المتكررة، مثل color:blue\|48.8584,2.2945\|48.8606,2.3376.
`size` / `--size`	نص; النمط: `^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$`	لا	600x400	الأبعاد بالبكسل WIDTHxHEIGHT؛ يحد التنفيذ كل بُعد إلى 1–640.
`zoom` / `--zoom`	عدد صحيح; `0–21`	لا	مُغفل؛ تختاره Google أو تستنتجه	مستوى تقريب صريح.

السلوك والقيود

يلزم واحد على الأقل من center أو markers أو path.
يجب ألا يتجاوز عنوان URL الكامل للطلب 16,384 محرفًا. نمط size في المخطط أوسع من حد 640 بكسل وقت التشغيل.
يتبع تنسيق العلامات والمسارات صياغة Google Static Maps. تبقى نسبة Google في الصورة الناتجة.

النتيجة

يعيد MCP محتوى image/png مضمنًا. يعيد CLI كائن JSON بصيغة {mimeType,base64}، أو بايتات PNG خامًا عند توفير --output.

مثال

معاملات MCP:

json

{
  "center": "48.8584,2.2945",
  "zoom": 14,
  "size": "320x240",
  "markers": [
    "color:red|48.8584,2.2945"
  ]
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_static_map --args '{"center":"48.8584,2.2945","zoom":14,"size":"320x240","markers":["color:red|48.8584,2.2945"]}'

maps_batch_geocode

ترميز جغرافي لما يصل إلى 50 عنوانًا، مع نجاح أو خطأ لكل عنوان وتزامن محدود.

ترميز قائمة عناوين محدودة جغرافيًا مع الحفاظ على ترتيب الإدخال ونجاح كل عنصر أو إخفاقه.

أمر CLI: batch-geocode. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`addresses` / `--addresses`	مصفوفة نصوص; `1–50` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	نصوص العناوين أو المعالم المطلوب حلّها.

السلوك والقيود

يستخدم تزامنًا محدودًا مع خمسة طلبات Google فعالة كحد أقصى لكل عملية.
لا تفرض إخفاقات العناصر حالة خروج CLI غير صفرية؛ افحص success وerror في كل صف.

النتيجة

مصفوفة بحسب ترتيب الإدخال. يتضمن كل صف address وsuccess وإما data (كائن الترميز الجغرافي) أو error.

مثال

معاملات MCP:

json

{
  "addresses": [
    "Paris, France",
    "London, UK"
  ]
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_batch_geocode --args '{"addresses":["Paris, France","London, UK"]}'

maps_explore_area

حل موقع واستكشاف فئات مع تفاصيل لأفضل النتائج. استخدم معالم محددة لتخطيط الرحلة.

حل موقع واحد والبحث في فئات مختارة حوله وتوسيع النتائج الأولى فقط في كل فئة.

أمر CLI: explore-area. الوصول إلى Google: تقبل Places مفتاح API أو OAuth. تحتاج المواقع المسماة مفتاح API لـ Geocoding أيضًا.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`location` / `--location`	نص; على الأقل 1 محرف	نعم	—	عنوان أو معلم أو نص latitude,longitude دقيق.
`radius` / `--radius`	رقم; `0.1–50000.0`	لا	1000	نصف قطر بحث الفئة بالأمتار.
`topN` / `--top-n`	عدد صحيح; `1–20`	لا	3	الحد الأقصى للأماكن في كل فئة المطلوب توسيع تفاصيلها.
`types` / `--types`	مصفوفة نصوص; `1–10` عناصر; كل عنصر لا يقل عن 1 محرف	لا	restaurant, cafe, tourist_attraction	فئات أماكن Google المراد البحث عنها.

السلوك والقيود

تبحث كل فئة في حتى 20 مكانًا؛ والعدد count هو عدد الصفحة المُعادة لا جردًا تجميعيًا.
تبقى إخفاقات الفئات والتفاصيل ظاهرة ضمن مخرجات المستوى الأعلى الناجحة.
يجري هذا الاستدعاء المركب عدة طلبات Google؛ قلل الفئات وtopN بما يناسب المهمة.

النتيجة

كائن يتضمن location المحلول وradius وcategories. لكل فئة type/count/top أو خطأ؛ وقد تحتوي الأماكن الموسعة details_error.

مثال

معاملات MCP:

json

{
  "location": "48.8584,2.2945",
  "types": [
    "cafe"
  ],
  "radius": 500,
  "topN": 1
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_explore_area --args '{"location":"48.8584,2.2945","types":["cafe"],"radius":500,"topN":1}'

maps_plan_route

تخطيط مسار يمر بـ 2–27 توقفًا. تحسين 2–25 توقفًا وسيطًا عدا النقل العام. تبقى الإحداثيات الدقيقة محفوظة.

تخطيط مسار واحد عبر توقفات مرتبة، مع طلب اختياري من Google لإعادة ترتيب الوسيطة وإبقاء النهايتين ثابتتين.

أمر CLI: plan-route. الوصول إلى Google: تقبل Routes وPlaces مفتاح API أو OAuth. يحتاج حل أسماء المواقع أيضًا مفتاح API لـ Geocoding؛ وتتجنب نصوص الإحداثيات الدقيقة ذلك البحث.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`avoid_highways` / `--avoid-highways`	منطقي	لا	false	تجنب الطرق السريعة؛ تُدعم true للقيادة فقط.
`avoid_tolls` / `--avoid-tolls`	منطقي	لا	false	تجنب طرق الرسوم؛ تُدعم true للقيادة فقط.
`departure_time` / `--departure-time`	نص; على الأقل 1 محرف	لا	غير مزوّد	لحظة المغادرة بصيغة RFC 3339 مع Z أو إزاحة UTC صريحة.
`mode` / `--mode`	نص; القيم: `driving`, `walking`, `bicycling`, `transit`	لا	driving	وسيلة التنقل. تستخدم القيادة توجيهًا يراعي حركة المرور.
`optimize` / `--optimize`	منطقي	لا	true، وفق تلك الشروط	طلب تحسين التوقفات الوسطية عندما يزيد مجموع التوقفات على ثلاثة ولا تكون الوسيلة transit.
`polylineQuality` / `--polyline-quality`	نص; القيم: `OVERVIEW`, `HIGH_QUALITY`	لا	HIGH_QUALITY عندما trafficSegments=true؛ وإلا تستخدم Google القيمة الافتراضية OVERVIEW	جودة الهندسة: OVERVIEW أو HIGH_QUALITY. يتقدم الاختيار الصريح دائمًا، بما فيه OVERVIEW مع trafficSegments=true. يتحكم بكثافة النقاط بصورة مستقلة عن حسابات حركة المرور.
`stops` / `--stops`	مصفوفة نصوص; `2–27` عناصر; كل عنصر لا يقل عن 1 محرف	نعم	—	عناوين أو معالم مرتبة أو نصوص latitude,longitude دقيقة؛ يبقى الأول والأخير نقطتي النهاية.
`trafficSegments` / `--traffic-segments`	منطقي	لا	false	خيار منطقي اختياري للقيادة فقط. يطلب TRAFFIC_ON_POLYLINE بهندسة ENCODED_POLYLINE؛ ويستخدم HIGH_QUALITY افتراضيًا ما لم تحدد polylineQuality صراحةً. تفعّل حركة المرور على الخطوط تسعير Compute Routes Enterprise الأعلى تكلفة؛ اتركه false إذا لم تحتج تفاصيل المقاطع.

السلوك والقيود

يدعم النقل العام نقطتي نهاية فقط ودون توقفات وسيطة.
يسري التحسين فقط عند أربعة توقفات إجمالًا أو أكثر (توقفان وسيطان على الأقل).
يحسّن هذا ترتيب التوقفات لمسار واحد، وليس توزيع المركبات أو المهام على أسطول.
عند trafficSegments=true يعيد Routes فترات NORMAL أو SLOW أو TRAFFIC_JAM. تستخدم المقاطع الموحّدة لكل مسار أو جزء خطه الخاص وفهارس نقاط مستقلة. فترات Google هي [start,end)؛ وتحتفظ هندسة المقطع برأس الحدود النهائي المشترك لتغطية الحافة الأخيرة. يُبلّغ عن التغطية المفقودة أو غير الصالحة بوضوح، ولا تُختلق حركة مرور عادية.
يمثل segmentMetadata.retrievedAt وقت جلب الاستجابة محليًا، وليس وقت رصد حركة المرور لدى المزود؛ تكون trafficObservedAt بقيمة null لأن Routes لا يعيدها. وتكون roadCategory وspeedLimit بقيمة null لأن استجابة Routes هذه لا توفرهما. لا تحدث استدعاءات ضمنية إلى Roads ولا تُطبّق معاملات محلية على المدة؛ تظل المدد توقعات Google.
مقاطع حركة المرور اختيارية وتقتصر على القيادة في هذا البرنامج. يطلب الخيار خطوطًا تتضمن حركة المرور ويُفعّل فوترة Compute Routes Enterprise. مواصفات الفترات؛ شروط تفعيل بنود التسعير الحالية.
تختار polylineQuality تفاصيل الهندسة التي تعيدها Google: تستخدم HIGH_QUALITY نقاطًا أكثر، وتزيد حجم الاستجابة وقد تزيد زمن الانتظار. يبقى اختيار OVERVIEW صراحةً صالحًا مع trafficSegments=true. عند إغفال الجودة تستخدم مقاطع المرور HIGH_QUALITY؛ وإلا تستخدم Google القيمة OVERVIEW. لا يصطنع البرنامج تفاصيل إضافية ولا يضيفها بالاستيفاء بين النقاط. الجودة مستقلة عن extraComputations؛ واختيار HIGH_QUALITY وحده لا يفعّل TRAFFIC_ON_POLYLINE. التعريف الرسمي لـ PolylineQuality.

النتيجة

كائن يتضمن mode وoptimized الفعّال وstops المحلولة المرتبة وlegs للعرض وtotal_distance وtotal_duration وpolyline والتحذيرات. القيمة durationSeconds لكل مقطع عدد ثوانٍ رقمي. عند trafficSegments=true، تتضمن المسارات والأجزاء أيضًا segments موحّدة وsegmentMetadata.

مثال

معاملات MCP:

json

{
  "stops": [
    "48.8584,2.2945",
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking",
  "optimize": false
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_plan_route --args '{"stops":["48.8584,2.2945","48.8606,2.3376","48.8530,2.3499"],"mode":"walking","optimize":false}'

maps_compare_places

البحث عن أماكن ومقارنتها بمعلومات مفصلة ومسافة قيادة اختيارية من userLocation.

العثور على قائمة أماكن مختصرة وإثراؤها، مع مقارنة مسافة القيادة من إحداثيات مستخدم دقيقة اختياريًا.

أمر CLI: compare-places. الوصول إلى Google: تقبل Places وRoutes الاختيارية مفتاح API أو OAuth.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`limit` / `--limit`	عدد صحيح; `1–20`	لا	5	الحد الأقصى للأماكن المطابقة المطلوب إثراؤها.
`query` / `--query`	نص; على الأقل 1 محرف	نعم	—	استعلام بحث نصي عن الأماكن.
`userLocation` / `--user-location`	كائن	لا	دون مقارنة مسافة أو وقت	إحداثيات مستخدم دقيقة لمقارنة مسافة اختيارية.
`userLocation.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`userLocation.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.

السلوك والقيود

تكون المقارنة بالقيادة؛ وليس للأداة معامل لتغيير وسيلة التنقل.
تُحفظ إخفاقات التفاصيل والمسافات بدل حذف أماكن قابلة للاستخدام بخلاف ذلك.
تُثرى القائمة المختصرة المطلوبة فقط.

النتيجة

كائن يتضمن places وdistance_error اختياريًا. قد تحتوي الأماكن details/details_error وdistance وdrive_time وdistance_errors لكل مكان.

مثال

معاملات MCP:

json

{
  "query": "cafes near Eiffel Tower, Paris",
  "userLocation": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "limit": 3
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_compare_places --args '{"query":"cafes near Eiffel Tower, Paris","userLocation":{"latitude":48.8584,"longitude":2.2945},"limit":3}'

maps_search_along_route

العثور على أماكن على طول مسار باستخدام خطه المشفر.

حساب مسار والبحث في Places باستخدام خطه المشفر، بدل تقريب الرحلة ببحث دائري واحد.

أمر CLI: search-along-route. الوصول إلى Google: تقبل Routes وPlaces مفتاح API أو OAuth. يحتاج حل أسماء المواقع أيضًا مفتاح API لـ Geocoding؛ وتتجنب نصوص الإحداثيات الدقيقة ذلك البحث.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`destination` / `--destination`	نص; على الأقل 1 محرف	نعم	—	عنوان أو معلم وجهة المسار أو نص latitude,longitude دقيق.
`maxResults` / `--max-results`	عدد صحيح; `1–20`	لا	5	الحد الأقصى لنتائج Places المطلوبة في صفحة الاستجابة.
`mode` / `--mode`	نص; القيم: `driving`, `walking`, `bicycling`, `transit`	لا	walking	وسيلة التنقل للمسار المستخدم في البحث.
`origin` / `--origin`	نص; على الأقل 1 محرف	نعم	—	عنوان أو معلم بداية المسار أو نص latitude,longitude دقيق.
`textQuery` / `--text-query`	نص; على الأقل 1 محرف	نعم	—	استعلام Places لتوقفات على المسار، مثل المقاهي أو محطات الشحن.

السلوك والقيود

الوسيلة الافتراضية هي walking، خلافًا لـ directions وmatrix وplan-route التي تفترض driving.
لا يحدث انتقال تلقائي بين الصفحات أو توسيع Place Details.
لا تعرض الأداة معاملات المغادرة والوصول أو التجنب المتاحة في directions.

النتيجة

كائن يتضمن places وroutingSummaries الاختيارية وroute المحسوب، بما فيه بيانات Google المختارة وإجماليات موحّدة.

مثال

معاملات MCP:

json

{
  "textQuery": "cafes",
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking",
  "maxResults": 3
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_search_along_route --args '{"textQuery":"cafes","origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking","maxResults":3}'

maps_local_rank_tracker

تتبع ترتيب البحث عبر شبكة جغرافية لـ 1–3 كلمات؛ يعيد ARP وATRP وSoLV وأخطاء لكل نقطة.

قياس ظهور المكان المستهدف ضمن أول 20 نتيجة Text Search عند كل نقطة في شبكة جغرافية.

أمر CLI: local-rank-tracker. الوصول إلى Google: مفتاح API أو OAuth للواجهة الأساسية.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`center` / `--center`	كائن	نعم	—	المركز الدقيق لشبكة المسح.
`center.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	—	خط عرض WGS84 بالدرجات العشرية؛ الشمال موجب.
`center.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	—	خط طول WGS84 بالدرجات العشرية؛ الشرق موجب.
`gridSize` / `--grid-size`	عدد صحيح; `3–7`	لا	3	عدد الصفوف والأعمدة؛ تُقبل كل الأعداد الصحيحة 3–7.
`gridSpacing` / `--grid-spacing`	رقم; `100.0–10000.0`	لا	1000	المسافة بالأمتار بين نقاط الشبكة المتجاورة.
`keyword` / `--keyword`	نص; على الأقل 1 محرف	لا	غير مزوّد	كلمة بحث واحدة؛ استخدم keyword أو keywords.
`keywords` / `--keywords`	مصفوفة نصوص; `1–3` عناصر; كل عنصر لا يقل عن 1 محرف	لا	غير مزوّد	من كلمة إلى ثلاث كلمات؛ لها الأولوية عند توفير الشكلين معًا.
`placeId` / `--place-id`	نص; على الأقل 1 محرف	نعم	—	معرّف المكان المستهدف، مع بادئة places/ اختيارية.

السلوك والقيود

يلزم keyword أو keywords على الأقل؛ ولا تعبّر صفوف المخطط المنفردة عن هذا البديل.
يتناسب عدد طلبات البحث مع عدد الكلمات × gridSize² (حتى 147 قبل الإعادات).
تُستبعد النقاط الفاشلة من مقاييس الترتيب، ولا تُعامل كغياب صالح. قد تكون المقاييس null عند عدم وجود مشاهدات قابلة للاستخدام.
ترتيب البحث ليس تقييم مراجعات المستخدمين للمكان. النتائج عينات من عمليات بحث نصي منحازة، وليست ضمانًا لترتيب المستخدم في Google Maps.

النتيجة

كائن يتضمن target وgrid_size وgrid_spacing_m ومقاييس وشبكة لكل كلمة. يوسّط ARP الترتيبات الموجودة؛ ويستخدم ATRP الترتيب 21 للطلبات الناجحة التي غاب فيها الهدف؛ وSoLV هو النسبة المئوية للنقاط الناجحة المصنفة ضمن أفضل 3. يكشف failed_points وfound_in التغطية.

مثال

معاملات MCP:

json

{
  "keyword": "cafe",
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "center": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "gridSize": 3,
  "gridSpacing": 500
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_local_rank_tracker --args '{"keyword":"cafe","placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","center":{"latitude":48.8584,"longitude":2.2945},"gridSize":3,"gridSpacing":500}'

maps_speed_limits

حدود السرعة بصلاحية Asset Tracking.

جلب حدود سرعة السيارات لمقاطع الطرق عبر مسار GPS أو معرّفات مطابقة Roads. الميزة مقيدة وتتطلب Asset Tracking؛ تفعيل Roads وحده لا يكفي.

أمر CLI: speed-limits. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ، حتى مع وضع OAuth؛ فعّل الخدمة والفوترة والقيود المناسبة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`path` / `--path`	مصفوفة كائنات; `1–100` عناصر	لا	غير مُرسل	من 1 إلى 100 نقطة GPS؛ لا يجتمع مع roadPlaceIds. تجري Google مطابقة للطريق قبل جلب الحد.
`path[].latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب لكل نقطة مسار	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`path[].longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب لكل نقطة مسار	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`roadPlaceIds` / `--road-place-ids`	مصفوفة نصوص; `1–100` عناصر; كل عنصر لا يقل عن 1 محرف	لا	غير مُرسل	من 1 إلى 100 معرّف مقطع من أدوات مطابقة الطرق؛ معرّفات الأنشطة العادية قد لا تملك بيانات. لا يجتمع مع path.
`units` / `--units`	نص; القيم: `KPH`, `MPH`	لا	KPH	وحدة حد السرعة: KPH للكم/ساعة أو MPH للميل/ساعة.

السلوك والقيود

تطلب Google ترخيص Asset Tracking؛ قد تحتفظ به مشاريع Premium المنقولة بهذه القدرة. حساب فوترة عادي أو API مفعلة لا يثبت الاستحقاق. كل عنصر speedLimits مفوتر، وقد يُفوتر الطلب الواحد عدة عناصر؛ اطلب أقل دفعة مفيدة.
للحدود المتغيرة تعاد السرعة القصوى للسيارات. البيانات ليست فورية وقد تكون مفقودة أو مقدرة أو قديمة؛ اتبع اللافتات ومتطلبات السلامة. يحتفظ خطأ 403 بسبب Google المنقح ويضيف إرشاد وصول، لكنه قد ينتج أيضًا عن التفعيل أو قيود المفتاح أو الأذونات؛ ليس كل 403 مشكلة ترخيص.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/roads/speed-limits

المصادر الأصلية: https://developers.google.com/maps/documentation/roads/speed-limits

النتيجة

استجابة Roads كاملة، بما فيها speedLimits مع placeId وspeedLimit وunits، وsnappedPoints الاختيارية للمسار والتحذيرات والبيانات الوصفية.

مثال

معاملات MCP:

json

{
  "roadPlaceIds": [
    "ChIJs5ydyTiuEmsR0fRSlU0C7k0"
  ],
  "units": "KPH"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_speed_limits --args '{"roadPlaceIds":["ChIJs5ydyTiuEmsR0fRSlU0C7k0"],"units":"KPH"}'

maps_autocomplete

اقتراح أماكن وعناوين أثناء الكتابة.

توقعات Places API New أثناء الكتابة، مع أماكن واستعلامات وترجيح أو قيد جغرافي وفلاتر الأنواع والمناطق وموضع المؤشر ورموز جلسة الفوترة التي يديرها المستدعي.

أمر CLI: autocomplete. الوصول إلى Google: مفتاح API أو OAuth لـ Places بنطاق Places/cloud-platform.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`includeFutureOpeningBusinesses` / `--include-future-opening-businesses`	منطقي	لا	false	تضمين الأنشطة التي ستفتح مستقبلًا.
`includePureServiceAreaBusinesses` / `--include-pure-service-area-businesses`	منطقي	لا	false	تضمين الأنشطة التي تزور العملاء أو توصل إليهم دون موقع عام.
`includeQueryPredictions` / `--include-query-predictions`	منطقي	لا	false	تضمين توقعات الاستعلام إضافة إلى توقعات الأماكن.
`includedPrimaryTypes` / `--included-primary-types`	مصفوفة نصوص; `0–5` عناصر; كل عنصر لا يقل عن 1 محرف	لا	جميع الأنواع	حتى خمسة أنواع أماكن أساسية؛ يجب أن تكون (cities) أو (regions) القيمة الوحيدة عند استخدامها.
`includedRegionCodes` / `--included-region-codes`	مصفوفة نصوص; `0–15` عناصر	لا	جميع المناطق	حتى 15 رمز منطقة CLDR من حرفين؛ يُتقاطع مع locationRestriction. المصفوفة الفارغة لا تقيد النتائج.
`input` / `--input`	نص; على الأقل 1 محرف	نعم	—	نص بحث غير فارغ، ولو اسم مكان أو عنوان جزئي.
`inputOffset` / `--input-offset`	عدد صحيح; `0–4294967295`	لا	نهاية الإدخال	موضع مؤشر يبدأ من الصفر بأحرف Unicode؛ لا يتجاوز طول input.
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	قيمة GOOGLE_MAPS_LANGUAGE المُهيأة	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`locationBias` / `--location-bias`	كائن	لا	ترجيح Google بحسب IP عند غياب الخيارين الجغرافيين	ترجيح حول دائرة أو مستطيل واحد؛ قد تظهر نتائج خارجه. لا يجتمع مع locationRestriction.
`locationBias.circle`	كائن	لا	غير مُرسل	منطقة دائرية؛ لا تجتمع مع rectangle.
`locationBias.circle.center`	كائن	عند توفير الكائن الأب	مطلوب مع الدائرة	مركز الدائرة بإحداثيات WGS84.
`locationBias.circle.center.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع المركز	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationBias.circle.center.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع المركز	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`locationBias.circle.radius`	رقم; `0.0–50000.0`	عند توفير الكائن الأب	مطلوب مع الدائرة	نصف قطر بالمتر حتى 50000؛ يجب أن يكون موجبًا في locationRestriction.
`locationBias.rectangle`	كائن	لا	غير مُرسل	مستطيل مغلق لا يجتمع مع circle؛ قد تعبر حدود الطول خط التاريخ.
`locationBias.rectangle.high`	كائن	عند توفير الكائن الأب	مطلوب مع المستطيل	الحد الشمالي الشرقي؛ خط عرضه لا يقل عن low.latitude.
`locationBias.rectangle.high.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationBias.rectangle.high.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`locationBias.rectangle.low`	كائن	عند توفير الكائن الأب	مطلوب مع المستطيل	الحد الجنوبي الغربي؛ خط عرضه لا يتجاوز high.latitude.
`locationBias.rectangle.low.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationBias.rectangle.low.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`locationRestriction` / `--location-restriction`	كائن	لا	ترجيح Google بحسب IP عند غياب الخيارين الجغرافيين	قصر النتائج على دائرة أو مستطيل واحد؛ لا يجتمع مع locationBias.
`locationRestriction.circle`	كائن	لا	غير مُرسل	منطقة دائرية؛ لا تجتمع مع rectangle.
`locationRestriction.circle.center`	كائن	عند توفير الكائن الأب	مطلوب مع الدائرة	مركز الدائرة بإحداثيات WGS84.
`locationRestriction.circle.center.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع المركز	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationRestriction.circle.center.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع المركز	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`locationRestriction.circle.radius`	رقم; `0.0–50000.0`	عند توفير الكائن الأب	مطلوب مع الدائرة	نصف قطر بالمتر حتى 50000؛ يجب أن يكون موجبًا في locationRestriction.
`locationRestriction.rectangle`	كائن	لا	غير مُرسل	مستطيل مغلق لا يجتمع مع circle؛ قد تعبر حدود الطول خط التاريخ.
`locationRestriction.rectangle.high`	كائن	عند توفير الكائن الأب	مطلوب مع المستطيل	الحد الشمالي الشرقي؛ خط عرضه لا يقل عن low.latitude.
`locationRestriction.rectangle.high.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationRestriction.rectangle.high.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`locationRestriction.rectangle.low`	كائن	عند توفير الكائن الأب	مطلوب مع المستطيل	الحد الجنوبي الغربي؛ خط عرضه لا يتجاوز high.latitude.
`locationRestriction.rectangle.low.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locationRestriction.rectangle.low.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع الحد	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`origin` / `--origin`	كائن	لا	المسافة محذوفة	إحداثيات مرجعية لحساب distanceMeters الجيوديسية.
`origin.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع نقطة المرجع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`origin.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع نقطة المرجع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`regionCode` / `--region-code`	نص; النمط: `^[A-Za-z]{2}$`	لا	غير مُرسل	رمز منطقة CLDR من حرفين للتنسيق والترتيب؛ لا يقصر النتائج عليها.
`sessionToken` / `--session-token`	نص; على الأقل 1 محرف; النمط: `^[A-Za-z0-9_-]+$`	لا	بلا تجميع جلسات؛ فوترة كل طلب	رمز آمن لعناوين URL ينشئه المستدعي، حتى 36 حرف ASCII؛ يُنصح بـ UUID v4 جديد لكل جلسة. أرسل الرمز نفسه إلى Place Details أو Address Validation الختامي.

السلوك والقيود

لا تنشئ الأداة الجلسات أو تنهيها تلقائيًا. يجب أن تستخدم الجلسة بيانات اعتماد مشروع Google Cloud واحد، وتنتهي بـ Place Details أو Address Validation مؤهل. أنشئ رمزًا جديدًا للجلسة التالية؛ غيابه أو إعادة استخدامه قد يؤدي لفوترة كل طلب.
نصف قطر الدائرة حتى 50000م، وموجب للقيد. يجب ترتيب حدود العرض بالمستطيل، مع دعم عبور خط التاريخ بالطول. احفظ إسناد Google Maps والمزود؛ قد تختلف شروط EEA وتوفر الحقول.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

المصادر الأصلية: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

النتيجة

استجابة suggestions كاملة: placePrediction/queryPrediction وتطابقات النص والتنسيق ومعرّفات الأماكن وdistanceMeters الاختيارية وكل البيانات الوصفية؛ لا قناع حقول يحذف المحتوى.

مثال

معاملات MCP:

json

{
  "input": "coffee near Paris",
  "sessionToken": "550e8400-e29b-41d4-a716-446655440000",
  "includedRegionCodes": [
    "FR"
  ],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "radius": 5000
    }
  },
  "includeQueryPredictions": true
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_autocomplete --args '{"input":"coffee near Paris","sessionToken":"550e8400-e29b-41d4-a716-446655440000","includedRegionCodes":["FR"],"locationBias":{"circle":{"center":{"latitude":48.8566,"longitude":2.3522},"radius":5000}},"includeQueryPredictions":true}'

maps_geolocate

تقدير الموقع من أبراج الهاتف وWi-Fi.

تقدير موقع جهاز من رصد أبراج الهاتف أو نقاط Wi-Fi باستخدام جسم Geolocation JSON الأصلي كاملًا.

أمر CLI: geolocate. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ، حتى مع وضع OAuth؛ فعّل الخدمة والفوترة والقيود المناسبة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`body` / `--body`	كائن	نعم	—	كائن Geolocation الأصلي: homeMobileCountryCode وhomeMobileNetworkCode وradioType ‏gsm/cdma/wcdma/lte/nr وcarrier وconsiderIp وcellTowers وwifiAccessPoints. يدعم cellId/newRadioCellId والإشارة. الجسم الفارغ يسمح بالرجوع إلى IP الخادم؛ Google تتحقق من الحقول الداخلية.

السلوك والقيود

افتراضي considerIp هو true. دون مشاهدات لاسلكية صالحة يحدد الرجوع موقع IP خروج الخادم، لا الشخص الذي يستخدم الوكيل؛ ضع body.considerIp=false لمنعه.
تحتاج Wi-Fi نقطتي وصول ثابتتين مختلفتين فعليًا على الأقل. تستبعد Google نطاقات MAC المحلية والمحجوزة؛ قد تفشل نقاط الاتصال المتنقلة والمشاهدات غير الصالحة. تتحقق Google من تفاصيل البروتوكول؛ يرفض الغلاف المعلمات الخارجية المجهولة. النتيجة تقريبية وقد تفشل بـ NOT_FOUND؛ افحص accuracy.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

المصادر الأصلية: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

النتيجة

حقول location.lat وlocation.lng وaccuracy (نصف قطر عدم اليقين بالمتر)، وأي حقول Google إضافية.

مثال

معاملات MCP:

json

{
  "body": {
    "considerIp": false,
    "wifiAccessPoints": [
      {
        "macAddress": "00:25:9c:cf:1c:ac",
        "signalStrength": -43
      },
      {
        "macAddress": "00:25:9c:cf:1c:ad",
        "signalStrength": -55
      }
    ]
  }
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_geolocate --args '{"body":{"considerIp":false,"wifiAccessPoints":[{"macAddress":"00:25:9c:cf:1c:ac","signalStrength":-43},{"macAddress":"00:25:9c:cf:1c:ad","signalStrength":-55}]}}'

maps_solar

معلومات المباني وطبقات الطاقة الشمسية.

استخدام طرق Solar الرئيسية الثلاث: أقرب مبنى وبيانات طبقات المنطقة وتنزيل GeoTIFF محدود بمعرّف الأصل.

أمر CLI: solar. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`additionalInsights` / `--additional-insights`	مصفوفة نصوص; `0–1` عناصر; القيم: `DETECTED_ARRAYS`	لا	بلا معلومات إضافية	القيمة DETECTED_ARRAYS الاختيارية لـ building_insights لكشف الألواح الموجودة على السطح.
`exactQualityRequired` / `--exact-quality-required`	منطقي	لا	false	اشتراط الجودة المختارة تمامًا بدل قبول جودة أعلى، للرؤى والطبقات.
`experiments` / `--experiments`	مصفوفة نصوص; `0–1` عناصر; القيم: `EXPANDED_COVERAGE`	لا	بلا تجارب	تجربة EXPANDED_COVERAGE الاختيارية للرؤى والطبقات؛ تصنفها Google قبل الإتاحة العامة.
`id` / `--id`	نص; على الأقل 1 محرف	لا	— لـ geo_tiff	معرّف أصل معتم من معلمة id في URL طبقة Solar؛ مطلوب لـ geo_tiff فقط. أرسل المعرّف لا الرابط.
`location` / `--location`	كائن	لا	غير مُرسل	موقع البحث عن المبنى أو مركز طبقات المنطقة؛ مطلوب لـ building_insights/data_layers.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب مع الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب مع الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`operation` / `--operation`	نص; القيم: `building_insights`, `data_layers`, `geo_tiff`	نعم	—	building_insights أو data_layers أو geo_tiff؛ تُقبل معلمات العملية المختارة فقط.
`pixelSizeMeters` / `--pixel-size-meters`	رقم; القيم: `0.1`, `0.25`, `0.5`, `1.0`	لا	0.1	حجم بكسل الطبقة الأدنى: 0.1 أو 0.25 أو 0.5 أو 1 متر؛ قد تكون الدقة الأصلية لبعض الطبقات أخشن.
`radiusMeters` / `--radius-meters`	رقم; دون حد–1000	لا	غير مُرسل	نصف قطر موجب لـ data_layers، حتى 1000م. فوق 100 يجب ألا يتجاوز pixelSizeMeters×1000؛ وفوق 175 يلزم عرض بلا تدفق شهري أو ظل ساعي.
`requiredQuality` / `--required-quality`	نص; القيم: `HIGH`, `MEDIUM`, `BASE`	لا	HIGH (افتراضي Google)	أقل جودة صور HIGH أو MEDIUM أو BASE؛ تستخدم BASE صور أقمار محسنة. يختلف التوفر جغرافيًا.
`view` / `--view`	نص; القيم: `DSM_LAYER`, `IMAGERY_LAYERS`, `IMAGERY_AND_ANNUAL_FLUX_LAYERS`, `IMAGERY_AND_ALL_FLUX_LAYERS`, `FULL_LAYERS`	لا	FULL_LAYERS (افتراضي Google)	مجموعة الطبقات: DSM_LAYER أو IMAGERY_LAYERS أو IMAGERY_AND_ANNUAL_FLUX_LAYERS أو IMAGERY_AND_ALL_FLUX_LAYERS أو FULL_LAYERS.

السلوك والقيود

التغطية والجودة تختلفان حسب الموقع؛ قد يفشل البحث بـ NOT_FOUND إن لم يوجد مبنى خلال نحو 50م. الروابط مؤقتة ومحمية؛ انسخ id فقط إلى geo_tiff، والتنزيل ثابت من solar.googleapis.com/v1/geoTiff:get دون جلب URL تعسفي.
حد الاستجابة 16 MiB مع ميزانية الطلبات والمهلة؛ قد تحتاج البيانات الكبيرة نصف قطر أصغر أو بكسلات أخشن. فك الراستر وتصميم التركيب خارج الأداة. EXPANDED_COVERAGE قبل الإتاحة العامة؛ قد تختلف شروط EEA ويحذف محتوى. لكل مسار فوترة وحصص منفصلة؛ احفظ إسناد Google Maps.
المراجع الرسمية والقيود: https://developers.google.com/maps/comms/eea/solar ; https://developers.google.com/maps/documentation/solar/coverage ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

المصادر الأصلية: https://developers.google.com/maps/comms/eea/solar, https://developers.google.com/maps/documentation/solar/coverage, https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest, https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get, https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

النتيجة

building_insights/data_layers تعيدان JSON كاملًا بالتواريخ والجودة والقدرة الشمسية والروابط المؤقتة بعد حذف بيانات الاعتماد. geo_tiff يعيد بايتات محدودة بالنوع الحقيقي وترويسات التخزين؛ JSON في CLI يستخدم base64.

مثال

معاملات MCP:

json

{
  "operation": "data_layers",
  "location": {
    "latitude": 37.444,
    "longitude": -122.16
  },
  "radiusMeters": 100,
  "view": "IMAGERY_AND_ANNUAL_FLUX_LAYERS"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_solar --args '{"operation":"data_layers","location":{"latitude":37.444,"longitude":-122.16},"radiusMeters":100,"view":"IMAGERY_AND_ANNUAL_FLUX_LAYERS"}'

maps_aerial_view

روابط فيديو Aerial View وبياناته.

جلب روابط تشغيل قصيرة العمر أو بيانات فيديو Aerial View موجود، دون تنزيل الفيديو.

أمر CLI: aerial-view. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ، حتى مع وضع OAuth؛ فعّل الخدمة والفوترة والقيود المناسبة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`address` / `--address`	نص; على الأقل 1 محرف	لا	غير مُرسل	عنوان بريدي مدعوم بالولايات المتحدة؛ اختر واحدًا فقط من address وvideoId.
`operation` / `--operation`	نص; القيم: `lookup`, `metadata`	لا	lookup	lookup يعيد روابط التشغيل والبيانات (بفوترة)؛ metadata يعيد البيانات بلا روابط (طريقة Google مجانية).
`videoId` / `--video-id`	نص; على الأقل 1 محرف	لا	غير مُرسل	معرّف فيديو Aerial View سابق؛ لا يجتمع مع address.

السلوك والقيود

العناوين المدعومة أميركية فقط وضمن تغطية 3D. تعيد الفيديوهات المفقودة NOT_FOUND؛ اطلب الإنشاء عبر maps_render_aerial_video. افحص الحالة باستخدام metadata المجاني بفواصل معقولة، واطلب lookup المفوتر عند الحاجة للتشغيل.
الروابط تنتهي سريعًا؛ اطلب رابطًا جديدًا لكل عرض. تمنع Google تنزيل الفيديوهات أو تخزينها أو حفظها مؤقتًا؛ الأداة تعيد روابط فقط. يجوز حفظ معرّفات الفيديو وفق الاستثناء الموثق. حافظ على الإسناد أثناء التشغيل؛ قد تختلف شروط EEA والوظائف.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/aerial-view/lookup-video ; https://developers.google.com/maps/documentation/aerial-view/policies"]

المصادر الأصلية: https://developers.google.com/maps/documentation/aerial-view/lookup-video, https://developers.google.com/maps/documentation/aerial-view/policies

النتيجة

استجابة Google الأصلية بحالة المعالجة أو النشاط والبيانات، وروابط التشغيل للتنسيقات والدقات عند النشاط. metadata لا يعيد روابط تشغيل.

مثال

معاملات MCP:

json

{
  "operation": "metadata",
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_aerial_view --args '{"operation":"metadata","address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_render_aerial_video

طلب إنشاء فيديو جوي صراحةً.

وضع طلب إنشاء فيديو Aerial View غير متزامن في الطابور لعنوان أميركي مدعوم. منفصل عن القراءة كي يميز الوكيل العملية المُغيرة.

أمر CLI: render-aerial-video. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ، حتى مع وضع OAuth؛ فعّل الخدمة والفوترة والقيود المناسبة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`address` / `--address`	نص; على الأقل 1 محرف	نعم	—	عنوان بريدي مدعوم بالولايات المتحدة لطلب إنشاء الفيديو.

السلوك والقيود

يغير الطلب طابور Google. لا تُعاد محاولته تلقائيًا بعد فشل عابر، ولا ينتظر الإكمال ولا ينزل الفيديو. افحص التقدم عبر maps_aerial_view metadata بالعنوان أو videoId؛ استخدم lookup لروابط التشغيل فقط.
تسري تغطية أميركا و3D والحصص وشروط الخدمة؛ تفعيل API لا يضمن إمكان الإنشاء. لا تنزل الفيديوهات أو تخزنها أو تحفظها مؤقتًا؛ اعرض روابط حديثة مع الإسناد.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

المصادر الأصلية: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

النتيجة

استجابة الإنشاء الأصلية بحالة وبيانات متاحة؛ PROCESSING يعني انتظارًا أو معالجة، وقد يعيد فيديو موجود بيانات ACTIVE مباشرة.

مثال

معاملات MCP:

json

{
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_render_aerial_video --args '{"address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_map_tiles

بلاطات خرائط 2D و3D وStreet View للعرض.

إنشاء جلسات Map Tiles واسترجاع موارد 2D و3D وStreet View لعارض خرائط؛ الأداة ليست عارضًا. ترخّص Google البلاطات للتصور فقط وتحظر التفسير الآلي وتحليل الصور وكشف الأشياء واستخراج البيانات الجغرافية والاستخدام دون اتصال.

أمر CLI: map-tiles. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`east` / `--east`	رقم; `-180.0–180.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط الطول الشرقي المطلوب؛ قد يكون سالبًا مع west موجب لعبور خط التاريخ.
`fov` / `--fov`	رقم; `30.0–120.0`	لا	90	مجال الرؤية الأفقي للصورة المصغرة، 30–120 درجة.
`height` / `--height`	عدد صحيح; `16–250`	لا	250	ارتفاع الصورة المصغرة، 16–250 بكسل.
`latitude` / `--latitude`	رقم; `-90.0–90.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locations` / `--locations`	مصفوفة كائنات; `1–100` عناصر	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	من موقع واحد إلى 100 لـ streetview_pano_ids، وكل كائن يحتوي lat وlng.
`locations[].lat`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	غير مُرسل؛ مطلوب للعمليات الموضحة	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`locations[].lng`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	غير مُرسل؛ مطلوب للعمليات الموضحة	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`longitude` / `--longitude`	رقم; `-180.0–180.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`north` / `--north`	رقم; `-90.0–90.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط العرض الشمالي المطلوب لـ viewport، ويجب أن يتجاوز south.
`operation` / `--operation`	نص; القيم: `create_session`, `tile_2d`, `viewport`, `root_3d`, `resource_3d`, `streetview_pano_ids`, `streetview_metadata`, `streetview_thumbnail`, `streetview_tile`	نعم	—	create_session، tile_2d، viewport، root_3d، resource_3d، streetview_pano_ids، streetview_metadata، streetview_thumbnail أو streetview_tile؛ تحدد العملية نقطة النهاية والحقول المطلوبة.
`panoId` / `--pano-id`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	مطلوب لبلاطة أو صورة Street View المصغرة، أو بديل الإحداثيات للبيانات الوصفية. لا تعتمد عليه بعد جلسة مستخدم واحدة.
`pitch` / `--pitch`	رقم; `-90.0–90.0`	لا	0	زاوية الكاميرا الرأسية بالدرجات، من ‎-90 إلى 90.
`radius` / `--radius`	رقم; `0.0–100000.0`	لا	50 مترًا	نصف قطر بحث Street View بالمتر، 0–100000، لـ pano_ids أو بحث metadata بالإحداثيات؛ لا يجتمع مع panoId.
`resourceUrl` / `--resource-url`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	لـ resource_3d: رابط Google مطلق https://tile.googleapis.com/v1/3dtiles/... من مجموعة البلاطات؛ بلا مضيف آخر أو منفذ مخصص أو بيانات مستخدم أو جزء أو مسار مشفر. يُحذف مفتاح الرابط وتستخدم بيانات الاعتماد المُهيأة.
`session` / `--session`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	رمز createSession؛ مطلوب لطلبات 2D وStreet View وليس 3D. اتبع expiry في الاستجابة.
`sessionOptions` / `--session-options`	كائن	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خيارات createSession الأصلية؛ mapType وlanguage وregion مطلوبة لـ create_session.
`sessionOptions.highDpi`	منطقي	لا	false	زيادة أبعاد البكسل بمقياس 2x أو 4x؛ لا تأثير مع 1x.
`sessionOptions.imageFormat`	نص; القيم: `jpeg`, `png`	لا	تختار Google التنسيق الأنسب	تنسيق jpeg أو png؛ لا يدعم JPEG الطبقات الشفافة.
`sessionOptions.language`	نص; على الأقل 1 محرف	عند توفير الكائن الأب	غير مُرسل؛ مطلوب للعمليات الموضحة	وسم لغة IETF مثل en-US.
`sessionOptions.layerTypes`	مصفوفة نصوص; `1–3` عناصر; القيم: `layerRoadmap`, `layerStreetview`, `layerTraffic`	لا	بلا طبقات إضافية	من طبقة واحدة إلى ثلاث: layerRoadmap وlayerStreetview وlayerTraffic. تحتاج terrain إلى layerRoadmap.
`sessionOptions.mapType`	نص; القيم: `roadmap`, `satellite`, `terrain`, `streetview`	عند توفير الكائن الأب	غير مُرسل؛ مطلوب للعمليات الموضحة	roadmap أو satellite أو terrain أو streetview؛ تحتاج terrain إلى layerRoadmap ضمن layerTypes.
`sessionOptions.overlay`	منطقي	لا	false	عند true تُعرض layerTypes دون الصورة الأساسية.
`sessionOptions.region`	نص; النمط: `^[A-Z]{2}$`	عند توفير الكائن الأب	غير مُرسل؛ مطلوب للعمليات الموضحة	رمز CLDR بحرفين كبيرين مثل US يصف الموقع الفعلي للمستخدم.
`sessionOptions.scale`	نص; القيم: `scaleFactor1x`, `scaleFactor2x`, `scaleFactor4x`	لا	scaleFactor1x	حجم عناصر الخريطة: scaleFactor1x أو scaleFactor2x أو scaleFactor4x.
`sessionOptions.styles`	مصفوفة كائنات; `1–100` عناصر	لا	نمط Google الافتراضي	كائنات تنسيق خريطة Google الأصلية، لـ roadmap فقط؛ الصيغة موثقة في مرجع Google.
`south` / `--south`	رقم; `-90.0–90.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط العرض الجنوبي المطلوب لـ viewport.
`west` / `--west`	رقم; `-180.0–180.0`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	خط الطول الغربي المطلوب لـ viewport.
`width` / `--width`	عدد صحيح; `16–600`	لا	600	عرض الصورة المصغرة، 16–600 بكسل.
`x` / `--x`	عدد صحيح; `0–4194303`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	عمود البلاطة؛ في 2D يجب أن يقل عن ‎2^zoom. حدود Street View تعتمد على أبعاد البانوراما الوصفية.
`y` / `--y`	عدد صحيح; `0–4194303`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	صف البلاطة؛ في 2D يجب أن يقل عن ‎2^zoom. حدود Street View تعتمد على أبعاد البانوراما الوصفية.
`yaw` / `--yaw`	رقم; `-360.0–360.0`	لا	0	اتجاه الكاميرا الأفقي للصورة المصغرة، من ‎-360 إلى 360 درجة.
`zoom` / `--zoom`	عدد صحيح; `0–22`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	تكبير صحيح: 0–22 لـ tile_2d/viewport و0–5 لـ streetview_tile. تحقق من توفر المستوى عبر viewport.

السلوك والقيود

create_session يحتاج sessionOptions؛ tile_2d يحتاج session/zoom/x/y؛ viewport يحتاج session/zoom/north/south/east/west؛ root_3d بلا حقول إضافية؛ resource_3d يحتاج resourceUrl؛ pano_ids يحتاج session/locations؛ metadata يحتاج session ومعرّف بانوراما أو زوج إحداثيات؛ thumbnail يحتاج session/panoId؛ streetview_tile يحتاج session/panoId/zoom/x/y. ترفض الحقول غير المستخدمة.
إنشاء الجلسة لا يعاد تلقائيًا؛ بحث البانوراما POST للقراءة فقط. العارض اللاحق مسؤول عن تجميع الصور والرسم. لا يوجد تخزين بلاطات أو تنزيل مناطق بالجملة أو خرائط دون اتصال أو تحليل صور. لا ترسل الصور إلى نموذج بصري للتفسير أو استخراج البيانات.
تحظر الاتفاقية الجلب المسبق والفهرسة والتخزين غير المصرح بها؛ احترم Cache-Control وETag. اعرض شعار Google Maps وإسناد المزود. استخدم حقوق viewport لـ2D، وحقوق Street View ورابط الإبلاغ، وإسناد البلاطات في عارض3D؛ لا تقص الاعتمادات. تختلف التغطية والفوترة والحصص وشروط EEA. اتبع expiry؛ معرّفات البانوراما عابرة.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/tile/2d-tiles-overview ; https://developers.google.com/maps/documentation/tile/3d-tiles ; https://developers.google.com/maps/documentation/tile/get-api-key ; https://developers.google.com/maps/documentation/tile/policies ; https://developers.google.com/maps/documentation/tile/session_tokens ; https://developers.google.com/maps/documentation/tile/streetview ; https://developers.google.com/maps/documentation/tile/style-reference ; https://tile.googleapis.com/v1/3dtiles/

المصادر الأصلية: https://developers.google.com/maps/documentation/tile/2d-tiles-overview, https://developers.google.com/maps/documentation/tile/3d-tiles, https://developers.google.com/maps/documentation/tile/get-api-key, https://developers.google.com/maps/documentation/tile/policies, https://developers.google.com/maps/documentation/tile/session_tokens, https://developers.google.com/maps/documentation/tile/streetview, https://developers.google.com/maps/documentation/tile/style-reference

النتيجة

JSON Google أصلي للجلسات والمنظور والبانوراما وملفات مجموعات 3D، مع الإسناد وحقوق النشر ورابط الإبلاغ وانتهاء الجلسة. الصور وموارد 3D غير JSON تعاد بايتات مع MIME وCache-Control وETag. يعرض MCP الصور المدعومة والباقي base64؛ يكتب CLI --output البايتات.

مثال

معاملات MCP:

json

{
  "operation": "root_3d"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_map_tiles --args '{"operation":"root_3d"}'

maps_streetview

بيانات Street View وصورة JPEG.

فحص بيانات بانوراما Street View أو جلب JPEG ثابت حسب الموقع أو المعرّف. يمكن فحص التوفر عبر metadata قبل الصورة المفوترة.

أمر CLI: streetview. الوصول إلى Google: مفتاح API مطلوب لـ Street View Static؛ OAuth وحده لا يكفي. فعّل Street View Static API. توصي Google بتوقيع رقمي وتشترطه بعض إعدادات الحساب.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`fov` / `--fov`	رقم; `1.0–120.0`	لا	90	مجال الرؤية الأفقي للصورة، 1–120 درجة.
`heading` / `--heading`	رقم; `0.0–360.0`	لا	توجه Google الكاميرا نحو الموقع المُرسل	اتجاه الكاميرا بالبوصلة، من 0 إلى 360 درجة.
`height` / `--height`	عدد صحيح; `1–640`	لا	400	ارتفاع الصورة 1–640 بكسل، لـ image فقط.
`location` / `--location`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	عنوان أو زوج إحداثيات نصي مثل 48.8584,2.2945 أو place_id:PLACE_ID؛ اختر واحدًا فقط من location وpanoId.
`operation` / `--operation`	نص; القيم: `metadata`, `image`	نعم	—	metadata لبيانات JSON أو image لبايتات JPEG.
`panoId` / `--pano-id`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	معرّف بانوراما Street View؛ قد يتغير ويجب عدم الاعتماد عليه طويلًا.
`pitch` / `--pitch`	رقم; `-90.0–90.0`	لا	0	زاوية الكاميرا الرأسية بالدرجات، من ‎-90 إلى 90.
`radius` / `--radius`	عدد صحيح; `0–100000`	لا	50	نصف قطر البحث بالمتر؛ يقبل التنفيذ أعدادًا صحيحة 0–100000.
`returnErrorCode` / `--return-error-code`	منطقي	لا	true في هذا التنفيذ	لـ image: إرجاع خطأ HTTP بدل الصورة الرمادية عند غياب الصور.
`signature` / `--signature`	نص; على الأقل 1 محرف	لا	غير مُرسل	توقيع URL اختياري محسوب للطلب المشفر نفسه؛ توصي به Google وقد تشترطه. تمرره الأداة ولا تنشئه. في الطلبات الموقّعة يُضاف signature أخيرًا بعد مفتاح API. وقّع المسار والاستعلام المرمّزين بدقة مع القيم الافتراضية المولّدة. ترتيب الصورة: location، radius، source، pano، size، heading، fov، pitch، return_error_code، key؛ تُحذف الخيارات غير المقدمة. تُحذف حقول الصورة من طلبات البيانات الوصفية. تُرمّز المسافات بعلامة +. القيم الافتراضية: size=640x400 وreturn_error_code=true.
`source` / `--source`	نص; القيم: `default`, `google`, `outdoor`	لا	default	مصدر البحث default أو google أو outdoor؛ يختلف التوفر حسب المجموعة والمنطقة.
`width` / `--width`	عدد صحيح; `1–640`	لا	640	عرض الصورة 1–640 بكسل، لـ image فقط. الأحجام الخاصة الأكبر غير مدعومة.

السلوك والقيود

اختر location أو panoId فقط. الأبعاد وheading وfov وpitch وreturnErrorCode للصور فقط؛ ترفض الحقول غير المستخدمة. metadata مجاني حاليًا ولا يستهلك حصة الصور؛ الصور مفوترة.
حافظ على الإسناد المدمج. يمنع استخدام Street View للطباعة وتسري قيود حفظ محتوى الخرائط؛ هذه الأداة لا تمنح ترخيص احتفاظ أو إعادة توزيع أو تحليل. تُمرر التواقيع فقط دون توليدها، ولا تُدعم الأحجام الخاصة. تختلف التغطية وEEA، وقد تتغير المعرّفات والتواريخ أو تغيب.
المراجع الرسمية والقيود: https://about.google/brand-resource-center/products-and-services/geo-guidelines/ ; https://developers.google.com/maps/documentation/streetview/metadata ; https://developers.google.com/maps/documentation/streetview/policies ; https://developers.google.com/maps/documentation/streetview/request-streetview

المصادر الأصلية: https://developers.google.com/maps/documentation/streetview/metadata, https://developers.google.com/maps/documentation/streetview/policies, https://developers.google.com/maps/documentation/streetview/request-streetview

النتيجة

JSON metadata الأصلي مع status وdate وlocation وpano_id وcopyright عند توفرها، أو بايتات JPEG مع MIME وترويسات تخزين آمنة. غياب الصور خطأ افتراضيًا. CLI --output يحفظ البايتات؛ MCP يعرض صورة وبياناتها.

مثال

معاملات MCP:

json

{
  "operation": "metadata",
  "location": "Eiffel Tower, Paris, France"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_streetview --args '{"operation":"metadata","location":"Eiffel Tower, Paris, France"}'

maps_streetview_publish

إدارة ونشر صور Street View للمستخدم.

إدارة صور وتسلسلات Google للمستخدم الموافق. يدعم كل طرق REST v1 الموثقة ورفع البايتات المحدود. النشر والحذف اختياران صريحان ولا يعادان تلقائيًا.

أمر CLI: streetview-publish. الوصول إلى Google: OAuth للمستخدم النهائي فقط بموافقة على https://www.googleapis.com/auth/streetviewpublish. استخدم بيانات authorized_user صريحة في GOOGLE_APPLICATION_CREDENTIALS ووضع OAuth. مفتاح حساب خدمة أو ADC ضمني أو API key منفرد مرفوض. تُجرى موافقة عميل OAuth خارجيًا؛ يجدّد البرنامج البيانات ولا يستضيف callback للمتصفح.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`dataBase64` / `--data-base64`	نص; على الأقل 4 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	بايتات وسائط بترميز base64 القياسي مع الحشو. الحجم بعد الفك من بايت واحد إلى 8 MiB؛ هذا حد التنفيذ وليس حد Google.
`filter` / `--filter`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	تعبير تصفية Google أصلي؛ تختلف القواعد حسب نقطة النهاية.
`inputType` / `--input-type`	نص; القيم: `VIDEO`, `XDM`	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	مطلوب لـ create_sequence: ‏VIDEO أو XDM.
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	افتراضي Google	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`mimeType` / `--mime-type`	نص; القيم: `image/jpeg`, `application/octet-stream`, `video/mp4`	لا	image/jpeg	نوع الوسائط للرفع: image/jpeg أو video/mp4 أو application/octet-stream.
`operation` / `--operation`	نص; القيم: `list`, `get`, `start_upload`, `upload`, `create`, `update`, `delete`, `batch_get`, `batch_update`, `batch_delete`, `list_sequences`, `get_sequence`, `start_sequence_upload`, `create_sequence`, `delete_sequence`	نعم	—	list/get/start_upload/upload/create/update/delete/batch_get/batch_update/batch_delete/list_sequences/get_sequence/start_sequence_upload/create_sequence/delete_sequence. عمليات النشر والتحديث والحذف تغير محتوى المستخدم العام.
`pageSize` / `--page-size`	عدد صحيح; `1–100`	لا	افتراضي خدمة Google	حجم الصفحة 1–100 لـ list أو list_sequences؛ قد تعيد Google عددًا أقل.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`photo` / `--photo`	كائن	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	كائن Photo أصلي لـ create/update. الإنشاء يحتاج uploadReference.uploadUrl بعد رفع البايتات؛ التحديث يحتاج photoId وupdateMask. راجع مخطط Photo الرسمي.
`photoId` / `--photo-id`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	معرّف صورة Google لـ get/update/delete فقط، بلا مسار أو معلمات URL.
`photoIds` / `--photo-ids`	مصفوفة نصوص; `1–100` عناصر; كل عنصر لا يقل عن 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	من معرّف صورة واحد إلى 100 لـ batch_get أو batch_delete.
`photoSequence` / `--photo-sequence`	كائن	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	كائن PhotoSequence أصلي لـ create_sequence؛ يتطلب uploadReference.uploadUrl وبيانات GPS/CAMM/IMU والالتقاط الملائمة.
`sequenceId` / `--sequence-id`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	معرّف التسلسل لـ get_sequence/delete_sequence؛ يأتي من اسم العملية المنشأة.
`updateMask` / `--update-mask`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	قناع حقول Google مطلوب للتحديث ومفصول بفواصل، مثل pose.heading أو pose.latLngPair.
`updatePhotoRequests` / `--update-photo-requests`	مصفوفة كائنات; `1–100` عناصر	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	من 1 إلى 100 كائن UpdatePhotoRequest أصلي لـ batch_update؛ كل عنصر يتطلب photo.photoId.id وupdateMask.
`uploadUrl` / `--upload-url`	نص; على الأقل 1 محرف	لا	غير مُرسل؛ مطلوب للعمليات الموضحة	رابط UploadRef الدقيق من start_upload/start_sequence_upload على HTTPS بالنطاق streetviewpublish.googleapis.com والمسار /media/user/{account}/photo/{reference} أو photoSequence؛ بلا إعادة توجيه أو أصل آخر أو بيانات مستخدم أو جزء أو مسار مشفر.
`view` / `--view`	نص; القيم: `BASIC`, `INCLUDE_DOWNLOAD_URL`	لا	BASIC	BASIC أو INCLUDE_DOWNLOAD_URL لـ list/get/batch_get/get_sequence. روابط التنزيل حساسة ولا تجلبها الأداة.

السلوك والقيود

مسار الصورة: start_upload ثم upload فعلي بالبايتات ثم create مع photo.uploadReference.uploadUrl والبيانات المطلوبة. رفع البايتات وحده لا ينشرها. تلزم صور360 وبيانات Photo Sphere/XMP ومعايير قبول Google. يستخدم update أسلوب PUT وupdateMask؛ تعديل البكسلات غير مدعوم من Google. الحذف يزيل صور المستخدم المنشورة. لا تنفذ فحوص doctor أو live أي كتابة.
مسار التسلسل: start_sequence_upload ثم upload ثم create_sequence مع inputType وphotoSequence ثم get_sequence. حد 8 MiB خاص بالتنفيذ؛ الفيديو الأكبر يحتاج رفعًا خارجيًا مدعومًا من Google ويمكن استخدام UploadRef الناتج. لا رفع مجزأ أو قابل للاستئناف.
تحافظ الأجسام الأصلية على GPS والوضعية وIMU والاتصالات والأماكن؛ Google تتحقق من التفاصيل الداخلية. الغلاف يرفض المعلمات المجهولة ويتحقق من الحقول الأساسية، وكل تحديث دفعة يحتاج photo.photoId.id وupdateMask. تنفيذ جميع طرق REST لا يعني اختبار كل حقل داخلي حيًا.
الرفع ثابت الأصل ومحدود وPOST بلا إعادة محاولات؛ تعطّل الإعادة لكل التغييرات لتجنب النشر المكرر عند فشل ملتبس. راجع النتائج صراحة. تسري الملكية والخصوصية وحقوق النشر ومعايير360 والمعالجة والحصص. حساب الخدمة لا يعوض موافقة المستخدم. لم يختبر النشر حيًا بمفتاح حساب الخدمة المقدم؛ يلزم مستخدم موافق، وتستبعد الفحوص الكتابات العامة.
المراجع الرسمية والقيود: https://developers.google.com/streetview/publish/authorizing ; https://developers.google.com/streetview/publish/first-app ; https://developers.google.com/streetview/publish/reference/rest ; https://developers.google.com/streetview/publish/reference/rest/v1/photo ; https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create ; https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate ; https://www.googleapis.com/auth/streetviewpublish

المصادر الأصلية: https://developers.google.com/streetview/publish/authorizing, https://developers.google.com/streetview/publish/first-app, https://developers.google.com/streetview/publish/reference/rest, https://developers.google.com/streetview/publish/reference/rest/v1/photo, https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create, https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate

النتيجة

Photo أو قوائم أو UploadRef أو نتائج دفعات أو Operation أصلية. استجابة الرفع أو الحذف الفارغة تصبح {}. تحفظ حالة النشر والملكية. قد يبقى التسلسل قيد المعالجة؛ افحصه عبر get_sequence. لا انتظار أو نشر تلقائي.

مثال

معاملات MCP:

json

{
  "operation": "list",
  "pageSize": 10,
  "view": "BASIC"
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_streetview_publish --args '{"operation":"list","pageSize":10,"view":"BASIC"}'

maps_datasets

إدارة مجموعات بيانات الخرائط.

إدارة مجموعات بيانات جغرافية لتنسيق Google Maps المعتمد على البيانات، مع استيراد غير متزامن من كائن Cloud Storage موجود.

أمر CLI: datasets. الوصول إلى Google: OAuth2 فقط بحساب خدمة أو ADC ونطاق https://www.googleapis.com/auth/cloud-platform؛ لا تقبل مفاتيح API. اضبط مشروع المورد وصلاحيات مشروع الحصة بصورة منفصلة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`dataset` / `--dataset`	كائن	لا	مطلوب لـ create/update	كائن Dataset الأصلي لـ create/update. الإنشاء يتطلب displayName فريدًا وusage:["USAGE_DATA_DRIVEN_STYLING"]. يُضاف اسم المورد المتوافق عند التحديث.
`gcsSource` / `--gcs-source`	كائن	لا	مطلوب للاستيراد	مصدر Cloud Storage موجود للاستيراد؛ يلزم حق الوصول. لا تُقرأ ملفات محلية.
`gcsSource.fileFormat`	نص; القيم: `FILE_FORMAT_GEOJSON`, `FILE_FORMAT_KML`, `FILE_FORMAT_CSV`	عند توفير الكائن الأب	مطلوب عند إرسال gcsSource	ترميز المصدر FILE_FORMAT_GEOJSON أو FILE_FORMAT_KML أو FILE_FORMAT_CSV.
`gcsSource.inputUri`	نص; على الأقل 1 محرف	عند توفير الكائن الأب	مطلوب عند إرسال gcsSource	عنوان gs://bucket/object موجود؛ يلزم storage.objects.get، مثل دور Storage Object Viewer.
`name` / `--name`	نص; النمط: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$`	لا	مطلوب لعمليات الموارد	projects/{project}/datasets/{dataset}؛ مطلوب عدا list/create. تقبل get اللاحقة @active لأحدث إصدار مكتمل.
`operation` / `--operation`	نص; القيم: `list`, `get`, `create`, `update`, `delete`, `import`, `download`, `fetch_errors`	نعم	مطلوب	اختر list/get/create/update/delete/import/download/fetch_errors؛ عمليات create/update/delete/import تغير موارد السحابة.
`pageSize` / `--page-size`	عدد صحيح; `1–500`	لا	list: 100؛ fetch_errors: افتراضي Google هو 50	أقصى مجموعات بيانات أو أخطاء بالصفحة؛ يقبل الغلاف 1–500.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`parent` / `--parent`	نص; النمط: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$`	لا	مطلوب لـ list/create	projects/{project}؛ مطلوب لـ list/create.
`tag` / `--tag`	نص; القيم: `active`	لا	أحدث إصدار بغض النظر عن حالة المعالجة	لـ list: القيمة active تختار أحدث إصدار مكتمل وتتجاوز مجموعات البيانات التي لا تملك إصدارًا مكتملًا.
`updateMask` / `--update-mask`	نص; على الأقل 1 محرف	لا	افتراضي Google هو * (استبدال كامل للبيانات الوصفية)	حقول البيانات الوصفية المفصولة بفواصل، مثل description,displayName؛ الإغفال يعني استبدال جميع البيانات الوصفية.
`versionDescription` / `--version-description`	نص; على الأقل 1 محرف	لا	محذوف	وصف إصدار البيانات الجديد؛ للاستيراد فقط.

السلوك والقيود

تحتاج العملية صلاحيات mapsplatformdatasets.datasets.list/get/create/update/delete/import/export المناسبة. استيراد GCS ينشئ إصدارًا جديدًا بصورة غير متزامنة؛ افحص الحالة عبر get والأخطاء عبر fetch_errors. لا يوجد انتظار تلقائي.
لا توثق واجهة v1 العامة listVersions؛ استخدم get للأحدث أو @active للمكتمل وversionId، دون ادعاء سرد كل التاريخ. التنزيل يحتاج صلاحية export ويكتب CLI --output البايتات.
لا تفرض Maps Datasets API رسوم استخدام، لكن يلزم مشروع مُهيأ وقد تُفوتر خرائط Google وCloud Storage وفق شروطهما. الاستخدام المدعوم تنسيق الخرائط بالبيانات؛ لا رفع محلي متعدد الأجزاء، بل كائن GCS موجود.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/datasets/create ; https://developers.google.com/maps/documentation/datasets/overview ; https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download ; https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets ; https://www.googleapis.com/auth/cloud-platform

المصادر الأصلية: https://developers.google.com/maps/documentation/datasets/create, https://developers.google.com/maps/documentation/datasets/overview, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets

النتيجة

استجابة Dataset أو قائمة أو أخطاء Google الأصلية، أو اسم إصدار الاستيراد، أو بايتات المصدر ونوعها وترويسات التخزين. تحفظ get حقول status.state وstatus.errorMessage وversionId؛ بدء الاستيراد لا يعني اكتمال المعالجة.

مثال

معاملات MCP:

json

{
  "operation": "list",
  "parent": "projects/my-project",
  "pageSize": 20
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_datasets --args '{"operation":"list","parent":"projects/my-project","pageSize":20}'

maps_route_optimization

تحسين مسارات أسطول كامل.

تحسين أساطيل التوصيل والخدمة عبر Route Optimization API باستخدام ShipmentModel الأصلي كاملًا، بما فيه السعات والنوافذ الزمنية والتكاليف.

أمر CLI: route-optimization. الوصول إلى Google: OAuth2 فقط بحساب خدمة أو ADC ونطاق https://www.googleapis.com/auth/cloud-platform؛ لا تقبل مفاتيح API. اضبط مشروع المورد وصلاحيات مشروع الحصة بصورة منفصلة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`name` / `--name`	نص; النمط: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$`	لا	مطلوب لـ get_operation	اسم projects/{project}[/locations/{location}]/operations/{ID} الدقيق من Google؛ لـ get_operation فقط.
`operation` / `--operation`	نص; القيم: `optimize`, `validate`, `batch`, `optimize_long_running`, `optimize_uri`, `get_operation`	نعم	مطلوب	optimize للحل المتزامن؛ validate يرسل VALIDATE_ONLY؛ batch لوظيفة GCS؛ optimize_long_running وoptimize_uri تجريبيتان؛ get_operation للحالة.
`parent` / `--parent`	نص; النمط: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$`	لا	مطلوب عدا get_operation	projects/{project}، اختياريًا /locations/-. الحل المتزامن والطويل يرفضان المواقع الإقليمية؛ batch/URI يقبلان الصيغة الأصلية.
`request` / `--request`	كائن	لا	مطلوب عدا get_operation	طلب Google كامل دون parent. الحل والتحقق يحتاجان model بالشحنات والمركبات والقيود. batch: من 1 إلى 100 modelConfigs بمصدر GCS ووجهة وJSON/PROTO_TEXT. ‏URI: ‏input.uri/output.uri بصيغة gs:// وتنتهي .json أو .txtpb.

السلوك والقيود

validate يستدعي Google مع VALIDATE_ONLY ولا يحل نموذج الأسطول. فعّل الخدمة؛ يتيح roles/routeoptimization.viewer الحل وقراءة العمليات، ويضيف editor الوظائف المجمعة. تشمل الصلاحيات locations.use وoperations.create/get.
وظائف batch تقرأ وتكتب GCS بصلاحيات تخزين صريحة، وقد تستمر بعد انتهاء الطلب. لا رفع ملفات أو انتظار تلقائي. نسخ long-running وURI تجريبية وقد تتغير؛ نقطة URI حساسة للحروف :OptimizeToursUri. لا تدعم Google حاليًا إلغاء العمليات أو حذفها أو سردها؛ يتوفر get_operation فقط.
تعتمد الفوترة على الشحنات وفئة Single Vehicle Routing أو Fleet Routing. هذه خدمة منفصلة عن تحسين نقاط Routes API؛ انتهاء مهلة النقل لا يلغي الوظيفة.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/route-optimization/cloud-setup ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours ; https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours ; https://developers.google.com/maps/documentation/route-optimization/usage-and-billing ; https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto ; https://www.googleapis.com/auth/cloud-platform

المصادر الأصلية: https://developers.google.com/maps/documentation/route-optimization/cloud-setup, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours, https://developers.google.com/maps/documentation/route-optimization/usage-and-billing, https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto

النتيجة

OptimizeToursResponse أو Operation أصلية؛ فحص الحالة يحفظ done:false والبيانات الوصفية وresponse/error عند الإكمال، دون إخفاء فشل العملية.

مثال

معاملات MCP:

json

{
  "operation": "validate",
  "parent": "projects/my-project",
  "request": {
    "model": {
      "shipments": [],
      "vehicles": [
        {
          "startLocation": {
            "latitude": 48.85,
            "longitude": 2.35
          }
        }
      ]
    },
    "maxValidationErrors": 10
  }
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_route_optimization --args '{"operation":"validate","parent":"projects/my-project","request":{"model":{"shipments":[],"vehicles":[{"startLocation":{"latitude":48.85,"longitude":2.35}}]},"maxValidationErrors":10}}'

maps_air_quality_forecast

توقع جودة الهواء ساعة بساعة.

جلب توقعات جودة الهواء لوقت أو فترة صريحة حتى 96 ساعة مستقبلًا.

أمر CLI: air-quality-forecast. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`customLocalAqis` / `--custom-local-aqis`	مصفوفة كائنات; `1–250` عناصر	لا	تختار Google المؤشرات المحلية	تجاوز المؤشر المحلي لبلدان أو مناطق محددة.
`customLocalAqis[].aqi`	نص; على الأقل 1 محرف	عند توفير الكائن الأب	مطلوب لكل تجاوز	رمز مؤشر محلي مدعوم مثل us_epa؛ تتحقق Google من التركيبة.
`customLocalAqis[].regionCode`	نص; النمط: `^[A-Za-z]{2}$`	عند توفير الكائن الأب	مطلوب لكل تجاوز	رمز بلد أو منطقة من حرفين لتطبيق التجاوز.
`dateTime` / `--date-time`	نص; على الأقل 20 محرف	لا	اختر محددًا زمنيًا	وقت UTC منفرد بتنسيق RFC3339 وينتهي بـ Z؛ تقرّبه Google للساعة السابقة. لا يجتمع مع period أو hours.
`extraComputations` / `--extra-computations`	مصفوفة نصوص; `1–5` عناصر; القيم: `LOCAL_AQI`, `HEALTH_RECOMMENDATIONS`, `POLLUTANT_ADDITIONAL_INFO`, `DOMINANT_POLLUTANT_CONCENTRATION`, `POLLUTANT_CONCENTRATION`	لا	بلا حسابات إضافية	حسابات إضافية: LOCAL_AQI وHEALTH_RECOMMENDATIONS وPOLLUTANT_ADDITIONAL_INFO وDOMINANT_POLLUTANT_CONCENTRATION وPOLLUTANT_CONCENTRATION.
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	Google: en	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`location` / `--location`	كائن	نعم	مطلوب	إحداثيات الموقع المطلوب؛ الحقول الداخلية مطلوبة.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`pageSize` / `--page-size`	عدد صحيح; `1–96`	لا	Google: التوقعات 24؛ السجل 72	عدد السجلات الساعية: حتى 96 للتوقع وحتى 168 للسجل.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`period` / `--period`	كائن	لا	اختر محددًا زمنيًا	فترة ساعية شاملة مرتبة: حتى 96 ساعة توقع أو 720 ساعة سجل. لا تجتمع مع dateTime أو hours.
`period.endTime`	نص; على الأقل 20 محرف	عند توفير الكائن الأب	مطلوب عند إرسال الفترة	نهاية الفترة الشاملة بتنسيق RFC3339 UTC وتنتهي بـ Z.
`period.startTime`	نص; على الأقل 20 محرف	عند توفير الكائن الأب	مطلوب عند إرسال الفترة	بداية الفترة بتنسيق RFC3339 UTC وتنتهي بـ Z.
`uaqiColorPalette` / `--uaqi-color-palette`	نص; القيم: `RED_GREEN`, `INDIGO_PERSIAN_DARK`, `INDIGO_PERSIAN_LIGHT`	لا	لوحة Google الافتراضية	لوحة UAQI: ‏RED_GREEN أو INDIGO_PERSIAN_DARK أو INDIGO_PERSIAN_LIGHT. لوحات المؤشرات المحلية ثابتة.
`universalAqi` / `--universal-aqi`	منطقي	لا	Google: true	إدراج مؤشر جودة الهواء العالمي.

السلوك والقيود

اختر محددًا زمنيًا واحدًا بالضبط؛ تُفحص الصيغة وترتيب الفترة وطولها محليًا، وتتحقق Google من التوفر الحالي والتغطية. تعاد صفحة واحدة؛ اتبع nextPageToken صراحة. تحفظ المؤشرات والتركيزات والتوصيات. تخضع النتائج لسياسات Air Quality والإسناد والعرض والتخزين، والتغطية تختلف حسب البلد.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

المصادر الأصلية: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

النتيجة

حقول hourlyForecasts وregionCode وnextPageToken الأصلية، مع بيانات الملوثات والصحة الاختيارية.

مثال

معاملات MCP:

json

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "dateTime": "2026-11-01T12:00:00Z",
  "pageSize": 24
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_air_quality_forecast --args '{"location":{"latitude":48.85,"longitude":2.35},"dateTime":"2026-11-01T12:00:00Z","pageSize":24}'

maps_air_quality_history

سجل جودة الهواء حتى 30 يومًا.

جلب معلومات جودة الهواء التاريخية خلال الثلاثين يومًا السابقة.

أمر CLI: air-quality-history. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`customLocalAqis` / `--custom-local-aqis`	مصفوفة كائنات; `1–250` عناصر	لا	تختار Google المؤشرات المحلية	تجاوز المؤشر المحلي لبلدان أو مناطق محددة.
`customLocalAqis[].aqi`	نص; على الأقل 1 محرف	عند توفير الكائن الأب	مطلوب لكل تجاوز	رمز مؤشر محلي مدعوم مثل us_epa؛ تتحقق Google من التركيبة.
`customLocalAqis[].regionCode`	نص; النمط: `^[A-Za-z]{2}$`	عند توفير الكائن الأب	مطلوب لكل تجاوز	رمز بلد أو منطقة من حرفين لتطبيق التجاوز.
`dateTime` / `--date-time`	نص; على الأقل 20 محرف	لا	اختر محددًا زمنيًا	وقت UTC منفرد بتنسيق RFC3339 وينتهي بـ Z؛ تقرّبه Google للساعة السابقة. لا يجتمع مع period أو hours.
`extraComputations` / `--extra-computations`	مصفوفة نصوص; `1–5` عناصر; القيم: `LOCAL_AQI`, `HEALTH_RECOMMENDATIONS`, `POLLUTANT_ADDITIONAL_INFO`, `DOMINANT_POLLUTANT_CONCENTRATION`, `POLLUTANT_CONCENTRATION`	لا	بلا حسابات إضافية	حسابات إضافية: LOCAL_AQI وHEALTH_RECOMMENDATIONS وPOLLUTANT_ADDITIONAL_INFO وDOMINANT_POLLUTANT_CONCENTRATION وPOLLUTANT_CONCENTRATION.
`hours` / `--hours`	عدد صحيح; `1–720`	لا	اختر واحدًا فقط من hours/dateTime/period	عدد الساعات السابقة من 1 إلى 720 (30 يومًا)؛ لا يجتمع مع dateTime أو period.
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	Google: en	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`location` / `--location`	كائن	نعم	مطلوب	إحداثيات الموقع المطلوب؛ الحقول الداخلية مطلوبة.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`pageSize` / `--page-size`	عدد صحيح; `1–168`	لا	Google: التوقعات 24؛ السجل 72	عدد السجلات الساعية: حتى 96 للتوقع وحتى 168 للسجل.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`period` / `--period`	كائن	لا	اختر محددًا زمنيًا	فترة ساعية شاملة مرتبة: حتى 96 ساعة توقع أو 720 ساعة سجل. لا تجتمع مع dateTime أو hours.
`period.endTime`	نص; على الأقل 20 محرف	عند توفير الكائن الأب	مطلوب عند إرسال الفترة	نهاية الفترة الشاملة بتنسيق RFC3339 UTC وتنتهي بـ Z.
`period.startTime`	نص; على الأقل 20 محرف	عند توفير الكائن الأب	مطلوب عند إرسال الفترة	بداية الفترة بتنسيق RFC3339 UTC وتنتهي بـ Z.
`uaqiColorPalette` / `--uaqi-color-palette`	نص; القيم: `RED_GREEN`, `INDIGO_PERSIAN_DARK`, `INDIGO_PERSIAN_LIGHT`	لا	لوحة Google الافتراضية	لوحة UAQI: ‏RED_GREEN أو INDIGO_PERSIAN_DARK أو INDIGO_PERSIAN_LIGHT. لوحات المؤشرات المحلية ثابتة.
`universalAqi` / `--universal-aqi`	منطقي	لا	Google: true	إدراج مؤشر جودة الهواء العالمي.

السلوك والقيود

اختر محددًا زمنيًا واحدًا بالضبط؛ تُفحص الصيغة وترتيب الفترة وطولها محليًا، وتتحقق Google من التوفر الحالي والتغطية. تعاد صفحة واحدة؛ اتبع nextPageToken صراحة. تحفظ المؤشرات والتركيزات والتوصيات. تخضع النتائج لسياسات Air Quality والإسناد والعرض والتخزين، والتغطية تختلف حسب البلد.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

المصادر الأصلية: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

النتيجة

حقول hoursInfo وregionCode وnextPageToken الأصلية، مع بيانات الملوثات والصحة الاختيارية.

مثال

معاملات MCP:

json

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 24,
  "pageSize": 12
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_air_quality_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":24,"pageSize":12}'

maps_air_quality_heatmap

بلاطات خريطة جودة الهواء.

تنزيل بلاطة خريطة حرارية حقيقية لمؤشر جودة هواء أو ملوث.

أمر CLI: air-quality-heatmap. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`mapType` / `--map-type`	نص; القيم: `UAQI_RED_GREEN`, `UAQI_INDIGO_PERSIAN`, `PM25_INDIGO_PERSIAN`, `GBR_DEFRA`, `DEU_UBA`, `CAN_EC`, `FRA_ATMO`, `US_AQI`	نعم	مطلوب	نوع المؤشر: UAQI_RED_GREEN، UAQI_INDIGO_PERSIAN، PM25_INDIGO_PERSIAN، GBR_DEFRA، DEU_UBA، CAN_EC، FRA_ATMO أو US_AQI.
`x` / `--x`	عدد صحيح; `0–65535`	نعم	مطلوب	عمود البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`y` / `--y`	عدد صحيح; `0–65535`	نعم	مطلوب	صف البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`zoom` / `--zoom`	عدد صحيح; `0–16`	نعم	مطلوب	مستوى تكبير Web Mercator من 0 إلى 16؛ المستوى صفر بلاطة واحدة.

السلوك والقيود

التوفر يعتمد على تغطية المؤشر والبلد. سياسات Air Quality تتطلب الإسناد وتحد التخزين والعرض؛ احفظ ترويسات التخزين. الغلاف لا يمنح ترخيص محتوى.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

النتيجة

بايتات بلاطة فعلية مع MIME وترويسات التخزين الأصلية؛ يعرض MCP صورة ويمكن لـ CLI --output حفظ البايتات.

مثال

معاملات MCP:

json

{
  "mapType": "UAQI_RED_GREEN",
  "zoom": 2,
  "x": 2,
  "y": 1
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_air_quality_heatmap --args '{"mapType":"UAQI_RED_GREEN","zoom":2,"x":2,"y":1}'

maps_pollen_heatmap

بلاطات خرائط حبوب اللقاح.

تنزيل بلاطة PNG حقيقية لمؤشر لقاح الأشجار أو العشب أو الأعشاب الضارة.

أمر CLI: pollen-heatmap. الوصول إلى Google: يلزم مفتاح API في هذا التنفيذ، حتى مع وضع OAuth؛ فعّل الخدمة والفوترة والقيود المناسبة.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`mapType` / `--map-type`	نص; القيم: `TREE_UPI`, `GRASS_UPI`, `WEED_UPI`	نعم	مطلوب	مؤشر لقاح TREE_UPI أو GRASS_UPI أو WEED_UPI.
`x` / `--x`	عدد صحيح; `0–65535`	نعم	مطلوب	عمود البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`y` / `--y`	عدد صحيح; `0–65535`	نعم	مطلوب	صف البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`zoom` / `--zoom`	عدد صحيح; `0–16`	نعم	مطلوب	مستوى تكبير Web Mercator من 0 إلى 16؛ المستوى صفر بلاطة واحدة.

السلوك والقيود

يتغير التوفر حسب البلدان المدعومة والموسم. تحكم سياسات Pollen الإسناد والعرض على Google Maps والتخزين المؤقت؛ تفعيل API لا يزيل قيود الترخيص.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/pollen/policies ; https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

المصادر الأصلية: https://developers.google.com/maps/documentation/pollen/policies, https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

النتيجة

بايتات بلاطة فعلية مع MIME وترويسات التخزين الأصلية؛ يعرض MCP صورة ويمكن لـ CLI --output حفظ البايتات.

مثال

معاملات MCP:

json

{
  "mapType": "TREE_UPI",
  "zoom": 2,
  "x": 2,
  "y": 1
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_pollen_heatmap --args '{"mapType":"TREE_UPI","zoom":2,"x":2,"y":1}'

maps_weather_history

سجل الطقس الساعي لليوم السابق.

استرجاع حتى 24 ساعة سابقة من الطقس مع ترقيم صفحات صريح.

أمر CLI: weather-history. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`hours` / `--hours`	عدد صحيح; `1–24`	لا	Google: 24	عدد الساعات السابقة بدءًا من الساعة الماضية، من 1 إلى 24.
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	Google: en	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`location` / `--location`	كائن	نعم	مطلوب	إحداثيات الموقع المطلوب؛ الحقول الداخلية مطلوبة.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`pageSize` / `--page-size`	عدد صحيح; `1–24`	لا	السجل: Google 24؛ غيره: افتراضي Google	أقصى عدد سجلات بالصفحة: 1–24 للسجل، و1–1000 للتنبيهات وتوقع الدقائق.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`unitsSystem` / `--units-system`	نص; القيم: `METRIC`, `IMPERIAL`	لا	Google: METRIC	نظام الوحدات METRIC أو IMPERIAL.

السلوك والقيود

يغطي هذا المسار الساعات الـ24 السابقة فقط، لا التواريخ القديمة التعسفية. تسري سياسات Weather وحدود التغطية؛ لا تُجلب الصفحات تلقائيًا.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

المصادر الأصلية: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

النتيجة

حقول historyHours وtimeZone وnextPageToken الأصلية وكامل الأحوال الساعية.

مثال

معاملات MCP:

json

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 12,
  "pageSize": 6
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_weather_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":12,"pageSize":6}'

maps_weather_alerts

تنبيهات الطقس العامة المحلية.

استرجاع تنبيهات الطقس المتقاطعة مع موقع، مع شدة التحذير ومعلومات الجهة المُصدرة الأصلية.

أمر CLI: weather-alerts. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`languageCode` / `--language-code`	نص; على الأقل 1 محرف	لا	Google: en	وسم لغة IETF BCP-47 للنص المتاح؛ قد تختار Google أقرب لغة مدعومة.
`location` / `--location`	كائن	نعم	مطلوب	إحداثيات الموقع المطلوب؛ الحقول الداخلية مطلوبة.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`pageSize` / `--page-size`	عدد صحيح; `1–1000`	لا	السجل: Google 24؛ غيره: افتراضي Google	أقصى عدد سجلات بالصفحة: 1–24 للسجل، و1–1000 للتنبيهات وتوقع الدقائق.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.

السلوك والقيود

تعتمد التغطية والتأخير والحقول على الجهة المُصدرة. احفظ إسناد مقدم التنبيه واتبع سياسات Weather؛ غياب تنبيه في النتيجة ليس ضمان سلامة.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

المصادر الأصلية: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

النتيجة

مجموعة weatherAlerts الأصلية وتفاصيل الجهة والمنطقة وnextPageToken عند توفره.

مثال

معاملات MCP:

json

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "pageSize": 5
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_weather_alerts --args '{"location":{"latitude":48.85,"longitude":2.35},"pageSize":5}'

maps_weather_minute_forecast

توقع هطول بالدقائق، تجريبي.

تجريبي: توقعات هطول عالية الدقة ضمن إطار ست ساعات.

أمر CLI: weather-minute-forecast. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`location` / `--location`	كائن	نعم	مطلوب	إحداثيات الموقع المطلوب؛ الحقول الداخلية مطلوبة.
`location.latitude`	رقم; `-90.0–90.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط العرض WGS84 بالدرجات، من ‎-90 إلى 90.
`location.longitude`	رقم; `-180.0–180.0`	عند توفير الكائن الأب	مطلوب عند إرسال الموقع	خط الطول WGS84 بالدرجات، من ‎-180 إلى 180.
`pageSize` / `--page-size`	عدد صحيح; `1–1000`	لا	السجل: Google 24؛ غيره: افتراضي Google	أقصى عدد سجلات بالصفحة: 1–24 للسجل، و1–1000 للتنبيهات وتوقع الدقائق.
`pageToken` / `--page-token`	نص; على الأقل 1 محرف	لا	الصفحة الأولى	رمز الصفحة التالية من الاستجابة السابقة؛ أبقِ بقية المعلمات دون تغيير. لا يوجد ترقيم تلقائي.
`unitsSystem` / `--units-system`	نص; القيم: `METRIC`, `IMPERIAL`	لا	Google: METRIC	نظام الوحدات METRIC أو IMPERIAL.

السلوك والقيود

تجريبي قبل الإتاحة العامة: قد يكون الدعم محدودًا والتغييرات غير متوافقة. يلزم الإسناد؛ الحد الأقصى لتخزين توقع الدقائق وبلاطات الطقس ساعة واحدة ثم يجب حذف النسخة. تمنع Google استخدام هذا المحتوى لإعادة إنشاء خدمة أو منتج Google، بما فيه تطبيق أو نموذج غرضه الأساسي معلومات الطقس. تسري القيود على المستهلكين اللاحقين.
قد لا تتزامن توقعات الدقائق مع البلاطات. صفحة واحدة في كل استدعاء؛ التوفر يعتمد على الموقع والوصول إلى الخدمة.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

المصادر الأصلية: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

النتيجة

حقول overallPredictionTimeframe وtimeZone وsegments وnextPageToken؛ تحفظ المقاطع النوع والاحتمال والكميات والشدة.

مثال

معاملات MCP:

json

{
  "location": {
    "latitude": 37.60451,
    "longitude": -80.59044
  },
  "pageSize": 5
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_weather_minute_forecast --args '{"location":{"latitude":37.60451,"longitude":-80.59044},"pageSize":5}'

maps_weather_map

خريطة الهطول الآني، تجريبية.

تجريبي: تنزيل بلاطة هطول آني للولايات المتحدة أو أوروبا.

أمر CLI: weather-map. الوصول إلى Google: مفتاح API أو رمز OAuth2 بنطاق cloud-platform؛ فعّل API والفوترة. يحتاج صاحب اعتماد مشروع الحصة صلاحية serviceusage.services.use.

المعاملات

المعامل / خيار CLI	النوع وحدود المخطط	مطلوب	القيمة عند الإغفال	الوصف
`mapType` / `--map-type`	نص; القيم: `US_PRECIPITATION_CURRENT`, `EU_PRECIPITATION_CURRENT`	نعم	مطلوب	US_PRECIPITATION_CURRENT أو EU_PRECIPITATION_CURRENT؛ تغطية آنية محدودة جغرافيًا.
`x` / `--x`	عدد صحيح; `0–65535`	نعم	مطلوب	عمود البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`y` / `--y`	عدد صحيح; `0–65535`	نعم	مطلوب	صف البلاطة من 0 إلى ‎2^zoom−1؛ تُفحص الحدود قبل الاتصال.
`zoom` / `--zoom`	عدد صحيح; `0–16`	نعم	مطلوب	مستوى تكبير Web Mercator من 0 إلى 16؛ المستوى صفر بلاطة واحدة.

السلوك والقيود

تجريبي قبل الإتاحة العامة: قد يكون الدعم محدودًا والتغييرات غير متوافقة. يلزم الإسناد؛ الحد الأقصى لتخزين توقع الدقائق وبلاطات الطقس ساعة واحدة ثم يجب حذف النسخة. تمنع Google استخدام هذا المحتوى لإعادة إنشاء خدمة أو منتج Google، بما فيه تطبيق أو نموذج غرضه الأساسي معلومات الطقس. تسري القيود على المستهلكين اللاحقين.
تقتصر التغطية على المناطق الأميركية والأوروبية الموضحة في دليل Google. صحة إحداثيات البلاطة لا تعني وجود بيانات للموقع.
المراجع الرسمية والقيود: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

المصادر الأصلية: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

النتيجة

بايتات بلاطة فعلية مع MIME وترويسات التخزين الأصلية؛ يعرض MCP صورة ويمكن لـ CLI --output حفظ البايتات.

مثال

معاملات MCP:

json

{
  "mapType": "US_PRECIPITATION_CURRENT",
  "zoom": 12,
  "x": 1025,
  "y": 1688
}

استدعاء CLI مكافئ:

mcp-gmap-rs call maps_weather_map --args '{"mapType":"US_PRECIPITATION_CURRENT","zoom":12,"x":1025,"y":1688}'

مرجع الأدوات ​

قواعد الاستدعاء ​

الأدوات ​

maps_geocode ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_validate_address ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_pollen ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_area_insights ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_snap_to_roads ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_nearest_roads ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_reverse_geocode ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_search_places ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_search_nearby ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_place_details ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_directions ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_distance_matrix ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_elevation ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_timezone ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_weather ​

المعاملات ​

السلوك والقيود ​

النتيجة ​

مثال ​

maps_air_quality ​

المعاملات ​

مرجع الأدوات

قواعد الاستدعاء

الأدوات

maps_geocode

المعاملات

السلوك والقيود

النتيجة

مثال

maps_validate_address

المعاملات

السلوك والقيود

النتيجة

مثال

maps_pollen

المعاملات

السلوك والقيود

النتيجة

مثال

maps_area_insights

المعاملات

السلوك والقيود

النتيجة

مثال

maps_snap_to_roads

المعاملات

السلوك والقيود

النتيجة

مثال

maps_nearest_roads

المعاملات

السلوك والقيود

النتيجة

مثال

maps_reverse_geocode

المعاملات

السلوك والقيود

النتيجة

مثال

maps_search_places

المعاملات

السلوك والقيود

النتيجة

مثال

maps_search_nearby

المعاملات

السلوك والقيود

النتيجة

مثال

maps_place_details

المعاملات

السلوك والقيود

النتيجة

مثال

maps_directions

المعاملات

السلوك والقيود

النتيجة

مثال

maps_distance_matrix

المعاملات

السلوك والقيود

النتيجة

مثال

maps_elevation

المعاملات

السلوك والقيود

النتيجة

مثال

maps_timezone

المعاملات

السلوك والقيود

النتيجة

مثال

maps_weather

المعاملات

السلوك والقيود

النتيجة

مثال

maps_air_quality

المعاملات