פרטי מקום

בחירת פלטפורמה: Android iOS JavaScript Web Service

אחזור שדות

אם יש לכם מזהה מקום או אובייקט קיים מסוג Place, תוכלו להשתמש ב-method‏ Place.fetchFields() כדי לקבל פרטים על המקום הזה. מציינים רשימה מופרדת בפסיקים של שדות נתוני המיקום שרוצים להציג. צריך לציין את שמות השדות באותיות רישיות גדולות (Camel Case). משתמשים באובייקט Place המוחזר כדי לקבל נתונים לשדות המבוקשים.

בדוגמה הבאה נעשה שימוש במזהה מקום כדי ליצור Place חדש, קוראים לפונקציה Place.fetchFields() ומבקשים את השדות displayName ו-formattedAddress, מוסיפים סמן למפה ומתעדים נתונים מסוימים במסוף.

TypeScript

async function getPlaceDetails() {
    const { Place } =  await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
    const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
    // Use place ID to create a new Place instance.
    const place = new Place({
        id: 'ChIJN5Nz71W3j4ARhx5bwpTQEGg',
        requestedLanguage: 'en', // optional
    });

    // Call fetchFields, passing the desired data fields.
    await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] });

    // Log the result
    console.log(place.displayName);
    console.log(place.formattedAddress);

    // Add an Advanced Marker
    const marker = new AdvancedMarkerElement({
        map,
        position: place.location,
        title: place.displayName,
    });
}

JavaScript

async function getPlaceDetails() {
  const { Place } = await google.maps.importLibrary("places");
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");
  // Use place ID to create a new Place instance.
  const place = new Place({
    id: "ChIJN5Nz71W3j4ARhx5bwpTQEGg",
    requestedLanguage: "en", // optional
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
    fields: ["displayName", "formattedAddress", "location"],
  });
  // Log the result
  console.log(place.displayName);
  console.log(place.formattedAddress);

  // Add an Advanced Marker
  const marker = new AdvancedMarkerElement({
    map,
    position: place.location,
    title: place.displayName,
  });
}
שימו לב ש-Map ו-Place הוגדרו לפני הפונקציה הזו:
const { Map } = await google.maps.importLibrary("maps");
const { Place } = await google.maps.importLibrary("places");
הדוגמה המלאה

שימוש ברכיב 'סקירה כללית של מקום'

הרכיב 'סקירה כללית של המקום' מציג מידע מפורט על מיליוני עסקים, כולל שעות פתיחה, ביקורות עם כוכבים ותמונות, וגם מסלולי הגעה ופעולות אחרות בממשק משתמש מוכן מראש ב-5 גדלים ופורמטים. הוא חלק מExtended Component Library (ספריית הרכיבים המורחבת) של הפלטפורמה של מפות Google. זוהי קבוצה של רכיבי אינטרנט שעוזרים למפתחים ליצור מפות ותכונות מיקום טובות יותר מהר יותר.

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