קישור למפות 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

תמחור

התכונה הזו נמצאת בשלב טרום-השקה (Preview) ואין עליה חיוב, כלומר החיוב הוא 0 $על השימוש במהלך תקופת ה-Preview. פרטים על התמחור המוצע מופיעים במאמר שימוש וחיובים ב-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 תומכות ביצירת קישור לקבלת מסלול בתגובה. המיקום הנוכחי משמש כמקום המוצא, מיקום המקום משמש כיעד וצורת התחבורה היא נסיעה.

בדוגמה הבאה נעשה שימוש בחיפוש בקרבת מקום (חדש) כדי לכלול את הקישור למפות Google עם מסלול הגעה בתשובה בשדה 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.