הגדרת 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 תראה. כתובות Pod או כתובות פרטיות של 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.