פרטי מקומות

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

אחזור שדות

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

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

TypeScript

async function getPlaceDetails(Place) {
    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(Place) {
  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 Element Library (ספריית הרכיבים המורחבת) מהפלטפורמה של מפות Google, קבוצה של רכיבי אינטרנט שעוזרים למפתחים ליצור מפות טובות יותר ואת תכונות המיקום מהר יותר.

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