إعداد Google Cloud

يصادق هذا الملف التنفيذي الطلبات الصادرة إلى Google باستخدام مفتاح API أو بيانات OAuth 2.0. ويصادق MCP_HTTP_TOKEN بصورة مستقلة العملاء المتصلين بخادم MCP HTTP لديك؛ ولا يحل اختيار Google OAuth محله.

تفعيل الخدمات والفوترة

في وحدة تحكم Google Cloud، اختر مشروعًا أو أنشئه، ثم اربط حساب فوترة نشطًا تحت Billing. فعّل الواجهات المطلوبة من APIs & Services → Library. تفعيل واجهة والسماح بها في قيود مفتاح API خطوتان منفصلتان. قد تترتب رسوم على الطلبات.

يصف الجدول التالي نقاط النهاية المستخدمة في هذا الإصدار من المشروع:

واجهة Google API	الخدمة المطلوب تفعيلها	المصادقة المستخدمة هنا
Places API (New)	places.googleapis.com	مفتاح API أو OAuth
Routes API	routes.googleapis.com	مفتاح API أو OAuth
Weather API	weather.googleapis.com	مفتاح API أو OAuth
Air Quality API	airquality.googleapis.com	مفتاح API أو OAuth
Address Validation API	addressvalidation.googleapis.com	مفتاح API أو OAuth
Places Aggregate API	areainsights.googleapis.com	مفتاح API أو OAuth
Pollen API	pollen.googleapis.com	مفتاح API
Roads API	roads.googleapis.com	مفتاح API
Geocoding API v3	geocoding-backend.googleapis.com	مفتاح API
Elevation API	elevation-backend.googleapis.com	مفتاح API
Time Zone API	timezone-backend.googleapis.com	مفتاح API
Maps Static API	static-maps-backend.googleapis.com	مفتاح API

لتفعيل الخدمات الاثنتي عشرة بحساب مسؤول مسجل في gcloud:

export PROJECT_ID='your-project-id'
gcloud services enable --project="$PROJECT_ID" \
  places.googleapis.com routes.googleapis.com \
  weather.googleapis.com airquality.googleapis.com \
  geocoding-backend.googleapis.com elevation-backend.googleapis.com \
  timezone-backend.googleapis.com static-maps-backend.googleapis.com \
  addressvalidation.googleapis.com areainsights.googleapis.com \
  pollen.googleapis.com roads.googleapis.com

تستخدم أداتا CLI المسمّاتان directions وdistance-matrix واجهة Routes API، فلا تلزم واجهتا Directions وDistance Matrix القديمتان. ما زال هذا المشروع يستخدم Geocoding v3 ؛ ولا يغير دعم OAuth في Geocoding v4 لدى Google مصادقة استدعاءات v3 هذه. قد تستدعي الأدوات المركبة عدة واجهات. وقد يحتاج تحويل أسماء المواقع أو المسار البديل إلى Geocoding حتى لو كانت العملية الأساسية تستخدم Places أو Routes. استخدم الإحداثيات لتجنب هذا الاعتماد أو احتفظ بمفتاح مقيّد لنقاط النهاية الخاصة بالمفتاح.

إنشاء مفتاح API مقيّد

1. افتح Google Maps Platform → Keys & Credentials في المشروع المحدد واختر Create credentials → API key.
2. اختر فقط الواجهات من الجدول التي سيستخدمها هذا المثيل. للمفتاح الموجود، عدّل قيود API واحفظها.
3. اضبط قيد التطبيق إلى IP addresses لتطبيق الخادم هذا. اسمح بعناوين الخروج العامة التي تراها Google. عناوين حجرات Kubernetes والعناوين الخاصة ليست عادة العنوان العام للمصدر؛ ويساعد عنوان Cloud NAT ثابت أو عنوان خروج آخر على ثبات هذا القيد.
4. خزّن المفتاح في .env مستثنى أو حقن البيئة أو Kubernetes Secret. راجع إرشادات Google لتقييد المفاتيح.

مثال .env:

GOOGLE_MAPS_AUTH_MODE=api-key
GOOGLE_MAPS_API_KEY=your-restricted-api-key

الوضع الافتراضي هو api-key. لا يغير توفير مسار حساب خدمة وحده وضع المصادقة. لا يتصل الاكتشاف بـ Google؛ استخدم استدعاءً حقيقيًا للتحقق من فوترة المشروع وتفعيل الواجهات والقيود:

mcp-gmap-rs geocode --address 'Paris, France'

الخطوات التالية

لـ JSON حساب الخدمة وADC والانتحال المحلي وهوية GKE، اتبع المصادقة. ثم اختر CLI أو MCP. يحدد مرجع الأدوات متطلبات بيانات اعتماد كل أداة.

الخدمات الإضافية والقيود

يدعم Solar وMap Tiles أيضًا OAuth. يتطلب Datasets وRoute Optimization استخدام OAuth وأذونات IAM لكل عملية. يتطلب Street View Publish ملف authorized_user محددًا صراحةً وموافقة المستخدم على النطاق streetviewpublish.

الخدمة	API	المصادقة
Geolocation API	geolocation.googleapis.com	مفتاح API
Solar API	solar.googleapis.com	مفتاح API / OAuth
Aerial View API	aerialview.googleapis.com	مفتاح API
Map Tiles API	tile.googleapis.com	مفتاح API / OAuth
Street View Static API	street-view-image-backend.googleapis.com	مفتاح API
Maps Platform Datasets API	mapsplatformdatasets.googleapis.com	OAuth / IAM
Route Optimization API	routeoptimization.googleapis.com	OAuth / IAM
Street View Publish API	streetviewpublish.googleapis.com	OAuth لمستخدم موافق؛ تُرفض حسابات الخدمة

يتطلب Speed Limits أهلية Asset Tracking المقيّدة. يقتصر Aerial View على العناوين الأمريكية المدعومة ويمنع تنزيل الفيديو أو تخزينه مؤقتًا. Map Tiles مخصص للعرض فقط؛ يُمنع التحليل الآلي واستخراج البيانات. أدوات Weather للدقائق والخرائط تجريبية، مع تخزين مؤقت أقصاه ساعة وقيود استخدام إضافية. توضح مراجع الأدوات الشروط والإسناد والحدود بالتفصيل.

Google: Speed Limits, Map Tiles, Aerial View, Street View Publish.