مهاجرت به جستجوی مکان جدید، مهاجرت به جستجوی مکان جدید

این صفحه تفاوت‌های بین ویژگی‌های جستجوی مکان مبتنی بر متن در کلاس Place (جدید) و PlacesService (قدیمی) را توضیح می‌دهد و چند قطعه کد برای مقایسه ارائه می‌دهد.

سرویس قدیمی PlacesService روش‌های جستجوی مبتنی بر متن زیر را دارد:

• متد findPlaceFromQuery() که یک کوئری متنی را دریافت کرده و یک نتیجه تک مکانی را برمی‌گرداند و از استفاده از فیلدهای داده مکانی پشتیبانی می‌کند.
• متد findPlaceFromPhoneNumber() که به شما امکان می‌دهد با استفاده از شماره تلفن، مکانی را جستجو کنید و از استفاده از فیلدهای داده مکان پشتیبانی می‌کند.
• متد textSearch() که یک کوئری متنی را دریافت کرده و لیستی از نتایج مکان را برمی‌گرداند. textSearch() قدیمی‌تر است و از استفاده از فیلدهای داده مکان پشتیبانی نمی‌کند.

کلاس جدید Place متد Place.searchByText() را ارائه می‌دهد که به شما امکان می‌دهد مکان‌ها را با استفاده از یک کوئری متنی یا شماره تلفن جستجو کنید و به شما امکان می‌دهد جستجوهای خود را با استفاده از مجموعه گسترده‌ای از فیلدهای داده مکان که مرتباً به‌روزرسانی می‌شوند و انواع مکان‌ها، سفارشی‌سازی کنید.

جدول زیر برخی از تفاوت‌های اصلی در متدهای جستجوی مکان بین کلاس Place و PlacesService را فهرست می‌کند:

مقایسه کد

این بخش، کد مربوط به روش‌های جستجوی متن را مقایسه می‌کند تا تفاوت‌های بین سرویس Places و کلاس Place را نشان دهد. قطعه کدها، کد مورد نیاز در هر API مربوطه برای ایجاد یک درخواست جستجوی مبتنی بر متن را نشان می‌دهند.

خدمات اماکن (قدیمی)

قطعه کد زیر استفاده از متد findPlaceFromQuery() را برای جستجوی یک مکان نشان می‌دهد. درخواست همگام است و شامل بررسی شرطی PlacesServiceStatus می‌شود. فیلدهای داده مکان مورد نیاز در بدنه درخواست مشخص شده‌اند که قبل از انجام درخواست واقعی تعریف شده است.

function findPlaces() {
  const request = {
    query: "Museum of Contemporary Art Australia",
    fields: ["name", "geometry"],
  };

  // Create an instance of PlacesService.
  service = new google.maps.places.PlacesService(map);

  // Make a findPlaceFromQuery request.
  service.findPlaceFromQuery(request, (results, status) => {
    let place = results[0];
    if (status === google.maps.places.PlacesServiceStatus.OK && results) {
      if (!place.geometry || !place.geometry.location) return;

      const marker = new google.maps.Marker({
        map,
        position: place.geometry.location,
      });
      map.setCenter(place.geometry.location);
    }
  });
}

بیشتر بدانید

• کد کامل مثال را ببینید
• مستندات را ببینید
• مرجع رابط FindPlaceFromQueryRequest

جستجوی متن (جدید)

قطعه کد زیر استفاده از متد searchByText() را برای جستجوی مکان‌ها نشان می‌دهد. درخواست ناهمزمان است و نیازی به بررسی وضعیت ندارد (می‌توان از مدیریت خطای استاندارد استفاده کرد). در این مثال، درخواست شامل maxResultCount برابر با ۸ است (مقدار باید بین ۱ تا ۲۰ باشد). این تابع نتایج را پیمایش می‌کند و برای هر کدام یک نشانگر اضافه می‌کند و مرزهای نقشه را بر اساس موقعیت نشانگرها تنظیم می‌کند. از آنجا که متد searchByText() از عملگر await استفاده می‌کند، فقط می‌توان از آن در داخل یک تابع async استفاده کرد.

async function findPlaces() {
  // Define a request.
  // The `fields` property is required; all others are optional.
  const request = {
    fields: ["displayName", "location", "businessStatus"],
    textQuery: "Tacos in Mountain View",
    includedType: "restaurant",
    locationBias: { lat: 37.4161493, lng: -122.0812166 },
    isOpenNow: true,
    language: "en-US",
    maxResultCount: 8,
    minRating: 3.2,
    region: "us",
    useStrictTypeFiltering: false,
  };

  // Call searchByText passing the request.
  const { places } = await google.maps.places.Place.searchByText(request);

  // Add a marker for each result.
  if (places.length) {
    const bounds = new google.maps.LatLngBounds();

    places.forEach((place) => {
      const markerView = new google.maps.marker.AdvancedMarkerElement({
        map,
        position: place.location,
        title: place.displayName,
      });

      bounds.extend(place.location);
      console.log(place);
    });
    map.fitBounds(bounds);
  } else {
    console.log("No results");
  }
}

متد searchByText() در مقایسه با نسخه قبلی، از گزینه‌های درخواست بسیار بیشتری پشتیبانی می‌کند، از جمله:

• includedType که به شما امکان می‌دهد جستجوها را به یک نوع مکان خاص محدود کنید.
• isOpenNow که به شما امکان می‌دهد جستجوها را فقط به مکان‌های باز محدود کنید.
• minRating که به شما امکان می‌دهد نتایج پایین‌تر از حد مشخص‌شده را فیلتر کنید (برای مثال، فقط مکان‌هایی را که سه ستاره یا بیشتر دارند، برگردانید).
• locationRestriction که نتایج خارج از مکان مشخص شده را حذف می‌کند ( locationBias نیز پشتیبانی می‌شود).

بیشتر بدانید

• کد کامل مثال را ببینید
• مستندات مربوط به جستجوی متن (جدید) را ببینید
• به مرجع searchByText() مراجعه کنید