קישור למפות Google

ניתן לשלוח לבקשות לנתוני מקומות באמצעות מגוון שיטות ב-Places API. התגובה של Places API מכילה נתונים על מקום מסוים, כולל נתוני מיקום ותמונות, מיקומים גיאוגרפיים ונקודות עניין בולטות.

במסגרת הגרסה הזו, התשובה מחיפוש טקסט, מחיפוש בקרבת מקום ומפרטי מקום יכולה לכלול גם קישורים למפות Google. המשתמשים יכולים לעבור לקישור הזה במפות Google כדי לראות מידע נוסף על המקום בתשובה.

לדוגמה, מחפשים שדות תעופה בסן פרנסיסקו, קליפורניה. התשובה תכלול את נמל התעופה הבינלאומי של סן פרנסיסקו (SFO) ברשימת המקומות. במהדורה הזו, האובייקט Place של SFO בתגובה מוסיף את השדה googleMapsUri שמכיל קישורים למפות Google כדי לפתוח את מפות Google עם המקום, מסלולי הגעה למקום, ביקורות על המקום ותמונות של המקום.

בנוסף לקישורים שנוספו לאובייקט Place, במהדורה הזו נוסף גם השדה googleMapsUri לאובייקטים Reviews ו-Photos בתגובה:

  • Reviews.googleMapsUri: מכיל קישור למפות Google לביקורת, כדי שתוכלו להציג אותה בדפדפן.

  • Photos.googleMapsUri: מכיל קישור לתמונה במפות Google, כדי שתוכלו להציג אותה בדפדפן.

ב-API Explorer אפשר לשלוח בקשות בזמן אמת כדי להתנסות באפשרויות החדשות האלה:

רוצים לנסות?

בטבלה הבאה מפורטים הקישורים למפות Google שאפשר לכלול בתשובה:

קישור למפות Google תיאור שם השדה
מקום קישור לפתיחת מפות Google עם המקום. googleMapsLinks.placeUri
מסלול קישור לפתיחת מסלול אל המקום במפות Google. googleMapsLinks.directionsUri
כתיבת ביקורת קישור לכתיבת ביקורת על המקום במפות Google. googleMapsLinks.writeAReviewUri
ביקורות קישור להצגת הביקורות על המקום במפות Google. googleMapsLinks.reviewsUri
תמונות קישור להצגת תמונות של המקום במפות Google. googleMapsLinks.photosUri

תמחור

התכונה הזו נמצאת בשלב תצוגה מקדימה לפני GA, והיא לא כרוכה בתשלום, כלומר החיוב הוא 0 $על השימוש במהלך התצוגה המקדימה. פרטים על התמחור המוצע מופיעים במאמר שימוש בחיוב ב-Places API.

הקישורים בתשובה לגבי המקומות נכללים בשדה googleMapsLinks. אם רוצים שהם יופיעו בתגובה, צריך לכלול את השדה googleMapsLinks במסכת השדות של הבקשה.

לדוגמה, חיפוש הטקסט הבא כולל את כל הקישורים למפות Google בתשובה:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

התגובה תהיה בפורמט:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

אין צורך להחזיר את כל הקישורים בתשובה. לדוגמה, אם רוצים לכלול בתגובה רק את הקישור לתמונות, משנים את מסכת השדות כפי שמתואר בהמשך כך שתכלול רק את השדה photosUri:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

הוספת מסלול בתשובה

כל השיטות של Places תומכות ביצירת קישור לקבלת מסלול בתשובה. המיקום הנוכחי משמש כמקום המוצא, מיקום המקום משמש כיעד וצורת התחבורה היא נסיעה.

בדוגמה הבאה נעשה שימוש בחיפוש בקרבת מקום כדי לכלול את הקישור למסלול במפות בתשובה בשדה directionsUri:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

בגרסה הזו נוסף השדה googleMapsUri לאובייקטים Reviews ו-Photos בתגובה. כשתלחצו על הקישורים האלה, הביקורת או התמונה ייפתח במפות Google.

לדוגמה, חיפוש הטקסט הבא כולל ביקורות ותמונות של כל מקום בתשובה:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

בתגובה, כל רכיב במערך הביקורות והתמונות מכיל את השדה googleMapsUri כדי לפתוח את הביקורת או את התמונה בדפדפן.

נסה בעצמך!

ב-API Explorer אפשר לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שלו.

  1. בוחרים בסמל ה-API, מרחיבים את API Explorer., בצד שמאל של הדף.

  2. אפשר גם להרחיב את האפשרות Show standard parameters ולהגדיר את הפרמטר fields למסכת השדה.

  3. אם רוצים, עורכים את גוף הבקשה.

  4. לוחצים על הלחצן Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

  5. בחלונית של API Explorer, בוחרים בסמל ההרחבה מרחיבים את API Explorer. כדי להרחיב את החלון של API Explorer.