เครื่องระบุตำแหน่งผลิตภัณฑ์ - คู่มือการใช้งาน

ภาพรวม

เว็บ iOS API

Google Maps Platform พร้อมใช้งานสำหรับเว็บ (JS, TS), Android และ iOS รวมถึงมี API บริการเว็บสำหรับการรับข้อมูลเกี่ยวกับสถานที่ เส้นทาง และระยะทาง ตัวอย่างในคู่มือนี้เขียนขึ้นสำหรับแพลตฟอร์มเดียว แต่มีลิงก์เอกสารประกอบสำหรับการติดตั้งใช้งานในแพลตฟอร์มอื่นๆ

เมื่อผู้ใช้เห็นผลิตภัณฑ์ของคุณทางออนไลน์ พวกเขาต้องการค้นหาวิธีที่ดีที่สุดและสะดวกที่สุดในการรับคำสั่งซื้อ คู่มือการติดตั้งใช้งานเครื่องมือระบุตำแหน่งผลิตภัณฑ์และเคล็ดลับการปรับแต่งคือสิ่งที่ Google แนะนำว่าเป็นการผสมผสาน API ของ Google Maps Platform ที่เหมาะสมที่สุดเพื่อสร้างประสบการณ์ที่ยอดเยี่ยมของผู้ใช้เครื่องมือระบุตำแหน่งผลิตภัณฑ์

เมื่อทำตามคู่มือการติดตั้งใช้งานนี้ คุณจะช่วยให้ลูกค้าเห็นข้อมูลโดยละเอียดที่จำเป็นในการค้นหาผลิตภัณฑ์ของคุณ และบอกเส้นทางไปยังร้านค้าที่มีสินค้าที่ลูกค้าต้องการ ไม่ว่าลูกค้าจะขับรถ ปั่นจักรยาน เดิน หรือใช้บริการขนส่งสาธารณะก็ตาม

สถาปัตยกรรมระบบของ Product Locator ที่เชื่อมต่อเว็บเบราว์เซอร์ เว็บเซิร์ฟเวอร์ ฐานข้อมูลสินค้าคงคลัง และ Google Maps Platform API
แผนภาพสถาปัตยกรรม (คลิกเพื่อขยาย)

เปิดใช้ API

หากต้องการใช้เครื่องมือระบุตำแหน่งผลิตภัณฑ์ คุณต้องเปิดใช้ API ต่อไปนี้ในคอนโซล Google Cloud ไฮเปอร์ลิงก์ต่อไปนี้จะนำคุณไปยังคอนโซล Google Cloud เพื่อเปิดใช้ API แต่ละรายการสำหรับโปรเจ็กต์ที่เลือก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าได้ที่การเริ่มต้นใช้งาน Google Maps Platform

ส่วนต่างๆ ของคู่มือการติดตั้งใช้งาน

การใช้งานและการปรับแต่งต่อไปนี้จะครอบคลุมอยู่ในส่วนนี้

  • ไอคอนเครื่องหมายถูกคือขั้นตอนการติดตั้งใช้งานหลัก
  • ไอคอนรูปดาวเป็นการปรับแต่งที่ไม่บังคับ แต่เราขอแนะนำให้ใช้เพื่อปรับปรุงโซลูชัน
เชื่อมโยงสถานที่ตั้งร้านค้ากับสถานที่ใน Google Maps Platform จับคู่สถานที่ตั้งของร้านค้ากับสถานที่ใน Google Maps Platform
ระบุตำแหน่งของผู้ใช้ เพิ่มฟังก์ชันการทำงานแบบพิมพ์ไปเรื่อยๆ เพื่อปรับปรุงประสบการณ์ของผู้ใช้ในทุกแพลตฟอร์มและปรับปรุงความถูกต้องของที่อยู่โดยใช้การกดแป้นพิมพ์น้อยที่สุด
ระบุร้านค้าที่ใกล้ที่สุด คำนวณระยะทางและระยะเวลาเดินทางสำหรับต้นทางและจุดหมายหลายแห่ง โดยระบุรูปแบบการเดินทางต่างๆ เช่น การเดิน การขับรถ ขนส่งสาธารณะ หรือการปั่นจักรยานได้ (ไม่บังคับ)
แสดงข้อมูลร้านค้า แสดงข้อมูลที่สมบูรณ์เกี่ยวกับร้านค้าเพื่อให้ผู้ใช้ไปยังร้านค้าได้ง่ายขึ้น
แสดงเส้นทางในการนำทาง รับข้อมูลเส้นทางจากต้นทางไปยังจุดหมายโดยใช้การเดินทางรูปแบบต่างๆ เช่น การเดิน การขับรถ การปั่นจักรยาน และขนส่งสาธารณะ
ส่งเส้นทางไปยังอุปกรณ์เคลื่อนที่ นอกจากการแสดงเส้นทางในหน้าเว็บแล้ว คุณยังส่งเส้นทางไปยังโทรศัพท์ของผู้ใช้เพื่อนำทางโดยใช้ Google Maps ขณะเดินทางได้ด้วย
แสดงสถานที่ตั้งของคุณบนแผนที่แบบอินเทอร์แอกทีฟ สร้างเครื่องหมายบนแผนที่ที่กำหนดเองเพื่อช่วยให้สถานที่ตั้งของคุณโดดเด่น และจัดรูปแบบแผนที่ให้ตรงกับสีของแบรนด์ แสดง (หรือซ่อน) จุดที่น่าสนใจ (POI) ที่เฉพาะเจาะจงบนแผนที่เพื่อช่วยให้ผู้ใช้ปรับทิศทางได้ดีขึ้น และควบคุมความหนาแน่นของ POI เพื่อป้องกันไม่ให้แผนที่ดูรก
รวมข้อมูลตำแหน่งที่กำหนดเองกับรายละเอียดสถานที่ รวมรายละเอียดสถานที่ตั้งที่กำหนดเองของคุณเข้ากับรายละเอียดสถานที่เพื่อให้ผู้ใช้มีชุดข้อมูลที่สมบูรณ์สำหรับการตัดสินใจ

เชื่อมโยงสถานที่ตั้งของร้านค้ากับสถานที่ใน Google Maps Platform

รับรหัสสถานที่

ตัวอย่างนี้ใช้: Places API (ใหม่) ภาษาอื่นๆ ที่ใช้ได้ JavaScript

คุณจะเห็นว่าคุณมีฐานข้อมูลของร้านค้าที่มีข้อมูลพื้นฐาน เช่น ชื่อของสถานที่นั้น ที่อยู่ และหมายเลขโทรศัพท์ และคุณต้องการเชื่อมโยงกับสถานที่ใน Google Maps Platform เป็นชุดปลายทางสุดท้ายที่ผู้ใช้สามารถรับสินค้าได้ หากต้องการดึงข้อมูลที่ Google Maps Platform มีเกี่ยวกับสถานที่นั้นๆ รวมถึงพิกัดทางภูมิศาสตร์และข้อมูลที่ผู้ใช้ให้ไว้ ให้ค้นหารหัสสถานที่ที่สอดคล้องกับร้านค้าแต่ละแห่งในฐานข้อมูลของคุณ คุณสามารถเรียกใช้ ปลายทาง การค้นหาข้อความ (ใหม่) ใน Places API (ใหม่) และขอเฉพาะฟิลด์ places.id ในมาสก์ฟิลด์ (ซึ่งจะทริกเกอร์ SKU รหัสเท่านั้นของ Search Essentials การค้นหาข้อความ)

ตัวอย่างต่อไปนี้แสดงการขอรหัสสถานที่สำหรับสำนักงาน Google ในลอนดอน

curl -X POST -d '{
  "textQuery" : "Google London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

คุณสามารถจัดเก็บรหัสสถานที่นี้ไว้ในฐานข้อมูลพร้อมกับข้อมูลร้านค้าที่เหลือ และใช้เป็นวิธีที่มีประสิทธิภาพในการขอข้อมูลเกี่ยวกับร้านค้า ต่อไปนี้เป็นวิธีการใช้รหัสสถานที่เพื่อเข้ารหัสพิกัดภูมิศาสตร์ ดึงข้อมูลรายละเอียดสถานที่ และขอเส้นทางไปยังสถานที่นั้น

เข้ารหัสพิกัดภูมิศาสตร์สถานที่ตั้งของคุณ

ตัวอย่างนี้ใช้ Geocoding API ภาษาอื่นๆ ที่ใช้ได้ JavaScript

หากฐานข้อมูลของร้านค้ามีที่อยู่แต่ไม่มีพิกัดทางภูมิศาสตร์ ให้ใช้ Geocoding API เพื่อรับละติจูดและลองจิจูดของที่อยู่นั้นเพื่อวัตถุประสงค์ในการคำนวณว่าร้านค้าใดอยู่ใกล้กับลูกค้ามากที่สุด คุณสามารถเข้ารหัสพิกัดภูมิศาสตร์ของร้านค้าในฝั่งเซิร์ฟเวอร์ จัดเก็บละติจูดและลองจิจูดในฐานข้อมูล และรีเฟรชอย่างน้อยทุก 30 วัน

ต่อไปนี้คือตัวอย่างการใช้ Geocoding API เพื่อรับละติจูดและลองจิจูดของรหัสสถานที่ที่แสดงผลสำหรับสำนักงานของ Google ในลอนดอน

```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_productlocator_v1_a
```

ระบุตำแหน่งของผู้ใช้

ตัวอย่างนี้ใช้: Place Autocomplete ใน Maps JavaScript API พร้อมใช้งานใน Android | iOS

องค์ประกอบสำคัญในเครื่องระบุตำแหน่งผลิตภัณฑ์คือการระบุตำแหน่งเริ่มต้นของผู้ใช้ คุณสามารถเสนอ 2 ตัวเลือกให้ผู้ใช้ระบุตำแหน่งเริ่มต้น ได้แก่ การพิมพ์ต้นทางของการค้นหา หรือการให้สิทธิ์เข้าถึงตำแหน่งทางภูมิศาสตร์ของเว็บเบราว์เซอร์หรือบริการตำแหน่งบนอุปกรณ์เคลื่อนที่

จัดการรายการที่พิมพ์โดยใช้การเติมข้อความอัตโนมัติ

ผู้ใช้ในปัจจุบันคุ้นเคยกับฟังก์ชันการเติมข้อความอัตโนมัติใน Google Maps เวอร์ชันสำหรับผู้บริโภค ฟังก์ชันนี้สามารถผสานรวมเข้ากับแอปพลิเคชันใดก็ได้โดยใช้ไลบรารี Places ของ Google Maps Platform บนอุปกรณ์เคลื่อนที่และเว็บ เมื่อผู้ใช้พิมพ์ที่อยู่ การเติมข้อความอัตโนมัติจะเติมส่วนที่เหลือให้โดยใช้วิดเจ็ต นอกจากนี้ คุณยังสามารถใช้ฟังก์ชันการเติมข้อความอัตโนมัติของคุณเองได้โดยใช้ Place Autocomplete Data API โดยตรง

ช่องป้อนข้อมูลการค้นหาที่แสดงคำแนะนำที่เติมข้อความอัตโนมัติสำหรับที่อยู่ขณะที่ผู้ใช้พิมพ์
ฟังก์ชันการเติมที่อยู่โดยอัตโนมัติ (คลิกเพื่อขยาย)

ในตัวอย่างต่อไปนี้ ให้เพิ่มไลบรารี Places และ Marker ลงในเว็บไซต์โดยเพิ่มพารามิเตอร์ libraries=places,marker ลงใน URL สคริปต์ของ Maps JavaScript API

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places,marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a" defer></script>

ถัดไป ให้เพิ่มองค์ประกอบคอนเทนเนอร์ลงในหน้าเว็บที่จะเพิ่มวิดเจ็ต PlaceAutocompleteElement ดังนี้

<div id="autocomplete-container"></div>

สุดท้าย ให้เริ่มต้นวิดเจ็ต PlaceAutocompleteElement และเพิ่มลงในคอนเทนเนอร์ การจำกัดการคาดคะเนการเติมข้อความอัตโนมัติของสถานที่ด้วย includedPrimaryTypes: ["geocode"] จะกำหนดค่าวิดเจ็ตให้ยอมรับที่อยู่ถนน ย่าน เมือง และรหัสไปรษณีย์ เพื่อให้ผู้ใช้สามารถป้อนข้อมูลที่เฉพาะเจาะจงในระดับใดก็ได้เพื่ออธิบายต้นทางของตน เมื่อผู้ใช้เลือกการคาดคะเน เหตุการณ์ gmp-select จะเริ่มทำงาน และคุณสามารถเรียกใช้ place.fetchFields() เพื่อขอช่อง location ที่มีละติจูดและลองจิจูดของจุดเริ่มต้นของผู้ใช้ คุณจะใช้พิกัดแผนที่เหล่านี้เพื่อระบุความสัมพันธ์ของสถานที่ตั้งกับจุดเริ่มต้น

// Create the PlaceAutocompleteElement, restricting predictions to
// geographical location types in the United Kingdom.
const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement({
  includedPrimaryTypes: ["geocode"],
  includedRegionCodes: ["gb"],
});
placeAutocomplete.placeholder = "Enter starting address, city, or zip code";
document.getElementById("autocomplete-container").appendChild(placeAutocomplete);

// When the user selects an address from the drop-down,
// fetch the place details and search for the nearest stores.
placeAutocomplete.addEventListener("gmp-select", async ({ placePrediction }) => {
  const place = placePrediction.toPlace();
  await place.fetchFields({
    fields: ["id", "location", "formattedAddress"],
  });
  searchFromOrigin(place);
});
}

ในตัวอย่างนี้ เมื่อผู้ใช้เลือกที่อยู่ ฟังก์ชัน searchFromOrigin() จะเริ่มทำงาน ซึ่งจะใช้ตำแหน่งของผลลัพธ์ที่ตรงกันซึ่งเป็นตำแหน่งของผู้ใช้ จากนั้นค้นหาตำแหน่งที่ใกล้ที่สุดโดยใช้พิกัดเหล่านั้นเป็นจุดเริ่มต้น ตามที่อธิบายไว้ในส่วนระบุร้านค้าที่ใกล้ที่สุด

มุมมองรายละเอียดสินค้าที่แสดงสถานที่ตั้งของร้านค้าใกล้เคียงพร้อมความพร้อมจำหน่ายสินค้าและระยะทาง
แสดงตัวเลือกสถานที่ตั้ง (คลิกเพื่อขยาย)

ขยายส่วนนี้เพื่อดูวิดีโอแนะนําการเพิ่มการเติมข้อความอัตโนมัติสําหรับสถานที่ลงในแอป

เว็บไซต์

แอป Android

แอป iOS

ใช้ตำแหน่งทางภูมิศาสตร์ของเบราว์เซอร์

หากต้องการขอและจัดการตำแหน่งทางภูมิศาสตร์ของเบราว์เซอร์ HTML5 โปรดดูวิธีเปิดใช้หน้าต่างใช้ตำแหน่งของฉัน

สิทธิ์ของเบราว์เซอร์สำหรับตำแหน่งของผู้ใช้
คำขอสิทธิ์ของเว็บเบราว์เซอร์ (คลิกเพื่อขยาย)

ระบุร้านค้าที่ใกล้ที่สุด

ตัวอย่างนี้ใช้ Routes Library, Maps JavaScript API นอกจากนี้ยังมี Routes API

เมื่อทราบตำแหน่งของผู้ใช้แล้ว คุณสามารถเปรียบเทียบตำแหน่งนี้กับตำแหน่งของร้านค้าได้ การดำเนินการนี้ด้วยคลาส RouteMatrix ในไลบรารี Routes, Maps JavaScript API (หรือฟีเจอร์ Compute Route Matrix ใน Routes API) จะช่วยให้ผู้ใช้เลือกสถานที่ที่สะดวกที่สุดสำหรับตนเองได้ตามเวลาขับรถหรือระยะทางบนถนน

วิธีมาตรฐานในการจัดระเบียบรายการสถานที่ตั้งคือการจัดเรียงตามระยะทาง บ่อยครั้งที่ระยะทางนี้คำนวณได้ง่ายๆ โดยใช้เส้นตรงจากผู้ใช้ไปยังสถานที่ แต่ก็อาจทำให้เข้าใจผิดได้ เส้นตรงอาจอยู่เหนือแม่น้ำที่ผ่านไม่ได้หรือผ่านถนนที่พลุกพล่านในเวลาที่สถานที่อื่นอาจสะดวกกว่า ซึ่งมีความสำคัญเมื่อคุณมีสถานที่ตั้งหลายแห่งที่อยู่ห่างกันไม่กี่กิโลเมตร

เมธอด RouteMatrix.computeRouteMatrix ทำงานโดยใช้รายการสถานที่ต้นทางและปลายทาง และแสดงผลไม่เพียงระยะทางในการเดินทางเท่านั้น แต่ยังแสดงระยะเวลาเดินทางระหว่างสถานที่เหล่านั้นด้วย ในกรณีของผู้ใช้ ต้นทางจะเป็นตำแหน่งที่ผู้ใช้อยู่ในปัจจุบันหรือจุดเริ่มต้นที่ต้องการ และปลายทางจะเป็นตำแหน่งของสถานที่ สามารถระบุต้นทางและปลายทางเป็นคู่พิกัด รหัสสถานที่ หรือที่อยู่ คุณสามารถใช้ RouteMatrix.computeRouteMatrix ร่วมกับค่ากำหนดการกำหนดเส้นทาง เช่น TRAFFIC_AWARE เพื่อแสดงผลลัพธ์ตามเวลาขับรถในปัจจุบันหรือในอนาคต

ตัวอย่างต่อไปนี้จะเรียกใช้ RouteMatrix.computeRouteMatrix ในไลบรารี Routes, Maps JavaScript API โดยระบุต้นทางของผู้ใช้และสถานที่ตั้งร้านค้าสูงสุด 25 แห่งพร้อมกัน

async function getDistances(originLocation) {
  const { RouteMatrix } = await google.maps.importLibrary("routes");
  const request = {
    origins: [originLocation],
    destinations: stores.slice(0, 25).map((store) => store.location),
    travelMode: google.maps.TravelMode.DRIVING,
    routingPreference: "TRAFFIC_AWARE",
    fields: ["distanceMeters", "durationMillis", "condition"],
  };
  return RouteMatrix.computeRouteMatrix(request);
}

function update(location) {
  if (!location) {
    return;
  }

  // ...

  // sort by spherical distance
  stores.sort((a, b) => {
    return (
      google.maps.geometry.spherical.computeDistanceBetween(
        new google.maps.LatLng(a.location),
        location
      ) -
      google.maps.geometry.spherical.computeDistanceBetween(
        new google.maps.LatLng(b.location),
        location
      )
    );
  });

  // display travel distance and time
  getDistances(location)
    .then(({ matrix }) => {
      const items = matrix.rows[0].items;
      for (let i = 0; i < items.length; i++) {
        if (items[i].condition === "ROUTE_EXISTS") {
          stores[i].travelDistance = items[i].distanceMeters;
          stores[i].travelDuration = items[i].durationMillis;
        }
      }
    })
    .finally(() => {
      renderCards(stores);
      autocompleteInput.disabled = false;
      isUpdateInProgress = false;
    });
}

คุณสามารถแสดงสถานะสินค้าคงคลังของผลิตภัณฑ์สำหรับสถานที่ตั้งที่อยู่ใกล้เคียงแต่ละแห่งได้โดยอิงตามฐานข้อมูลสินค้าคงคลังของคุณ

แสดงข้อมูลร้านค้า

ตัวอย่างนี้ใช้ Places Library, Maps JavaScript API พร้อมให้บริการด้วย: Places SDK สำหรับ Android | Places SDK สำหรับ iOS | Places API (ใหม่)

คุณสามารถแชร์รายละเอียดสถานที่ที่สมบูรณ์ เช่น ข้อมูลติดต่อ เวลาทำการ และสถานะการเปิดทำการในปัจจุบัน เพื่อช่วยให้ลูกค้าเลือกสถานที่ที่ต้องการหรือทำการสั่งซื้อให้เสร็จสมบูรณ์

หลังจากเรียกใช้ Maps JavaScript API เพื่อดูรายละเอียดสถานที่ คุณจะกรองและแสดงผลการตอบกลับได้

ตัวเลือกร้านค้าใกล้เคียงที่แสดงสถานะสต็อกสินค้า เวลาทำการ และระยะทางในการเดินทาง
แสดงตัวเลือกร้านค้า (คลิกเพื่อขยาย)

หากต้องการขอรายละเอียดสถานที่ คุณจะต้องมีรหัสสถานที่ของแต่ละสถานที่ตั้ง ดูรับรหัสสถานที่เพื่อเรียกข้อมูลรหัสสถานที่ของสถานที่ตั้ง

คำขอรายละเอียดสถานที่ต่อไปนี้ใช้คลาส Place เพื่อแสดงชื่อ พิกัด เว็บไซต์ หมายเลขโทรศัพท์ คะแนน และเวลาทำการสำหรับรหัสสถานที่ของ Google London

const place = new google.maps.places.Place({
  id: 'ChIJVSZzVR8FdkgRTyQkxxLQmVU',
});

await place.fetchFields({ fields: [ 'displayName', 'nationalPhoneNumber', 'location', 'regularOpeningHours', 'rating', 'utcOffsetMinutes', 'websiteURI', ], });

createMarker(place);


ปรับปรุงเครื่องมือระบุตำแหน่งผลิตภัณฑ์

คุณสามารถปรับปรุงประสบการณ์ของผู้ใช้เพิ่มเติมได้ ทั้งนี้ขึ้นอยู่กับความต้องการของธุรกิจหรือผู้ใช้

แสดงเส้นทางในการนำทาง

ตัวอย่างนี้ใช้ Routes Library, Maps JavaScript API นอกจากนี้ยังมีเว็บเซอร์วิส Routes API สำหรับใช้ใน Android และ iOS ไม่ว่าจะโดยตรงจากแอปพลิเคชันหรือจากระยะไกลผ่านพร็อกซีเซิร์ฟเวอร์

เมื่อคุณแสดงเส้นทางแก่ผู้ใช้จากภายในเว็บไซต์หรือแอปพลิเคชัน ผู้ใช้ไม่จำเป็นต้องออกจากเว็บไซต์และเสียสมาธิกับหน้าอื่นๆ หรือเห็นคู่แข่งบนแผนที่ นอกจากนี้ Routes API ยังช่วยให้คุณขอเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมเพื่อประมาณการใช้เชื้อเพลิงหรือพลังงาน และแสดงผลกระทบต่อสิ่งแวดล้อมของการเดินทางได้ด้วย

คลาส Route ใน Routes Library, Maps JavaScript API ยังมีเมธอดต่างๆ เช่น createPolylines() และ createWaypointAdvancedMarkers() ที่ช่วยให้คุณประมวลผลผลลัพธ์และแสดงผลลัพธ์เหล่านั้นบนแผนที่ได้

ต่อไปนี้เป็นตัวอย่างการขอและแสดงเส้นทางบนแผนที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวอย่างได้ที่รับเส้นทาง

ส่งเส้นทางไปยังอุปกรณ์เคลื่อนที่

คุณสามารถส่งข้อความหรืออีเมลลิงก์เส้นทางให้ผู้ใช้เพื่อช่วยให้เดินทางไปยังสถานที่ได้ง่ายขึ้น เมื่อคลิกแล้ว แอป Google Maps จะเปิดขึ้นในโทรศัพท์หากติดตั้งไว้ หรือ maps.google.com จะโหลดในเว็บเบราว์เซอร์ของอุปกรณ์ ประสบการณ์ทั้ง 2 แบบนี้จะให้ตัวเลือกแก่ผู้ใช้ในการใช้การนำทางแบบเลี้ยวต่อเลี้ยว รวมถึงการนำทางด้วยเสียงเพื่อไปยังจุดหมาย

ใช้ URL ของ Maps เพื่อเขียน URL ของเส้นทาง เช่น URL ต่อไปนี้ โดยมีชื่อสถานที่ที่เข้ารหัส URL เป็นพารามิเตอร์ destination และรหัสสถานที่เป็นพารามิเตอร์ destination_place_id การเขียนหรือใช้ URL ของ Maps ไม่มีค่าใช้จ่าย คุณจึงไม่จำเป็นต้องใส่คีย์ API ใน URL

https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU

คุณสามารถระบุพารามิเตอร์การค้นหา origin โดยใช้รูปแบบที่อยู่เดียวกับปลายทางได้ (ไม่บังคับ) แต่หากไม่ระบุ เส้นทางจะเริ่มต้นจากตำแหน่งปัจจุบันของผู้ใช้ ซึ่งอาจแตกต่างจากตำแหน่งที่ผู้ใช้ใช้แอป Product Locator Maps URL มีตัวเลือกพารามิเตอร์การค้นหาเพิ่มเติม เช่น travelmode และ dir_action=navigate เพื่อเปิดเส้นทางโดยเปิดการนำทางไว้

ลิงก์ที่คลิกได้นี้ซึ่งขยาย URL ตัวอย่างก่อนหน้าจะตั้งค่า origin เป็นสนามฟุตบอลในลอนดอน และใช้ travelmode=transit เพื่อแสดงเส้นทางขนส่งสาธารณะไปยังจุดหมายปลายทาง

หากต้องการส่งข้อความหรืออีเมลที่มี URL นี้ เราขอแนะนำให้ใช้แอปพลิเคชันของบุคคลที่สาม เช่น twilio หากใช้ App Engine คุณสามารถใช้บริษัทบุคคลที่สามเพื่อส่งข้อความ SMS หรืออีเมลได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ การส่งข้อความด้วยบริการของบุคคลที่สาม

แสดงสถานที่ตั้งของคุณบนแผนที่แบบอินเทอร์แอกทีฟ

ใช้แผนที่แบบไดนามิก

ตัวอย่างนี้ใช้: Maps JavaScript API พร้อมใช้งานใน Android | iOS

เครื่องมือระบุตำแหน่งเป็นส่วนสำคัญของประสบการณ์ของผู้ใช้ อย่างไรก็ตาม บางเว็บไซต์อาจไม่มีแม้แต่แผนที่แบบง่ายๆ ซึ่งทำให้ผู้ใช้ต้องออกจากเว็บไซต์หรือแอปเพื่อค้นหาสถานที่ใกล้เคียง ซึ่งหมายความว่าผู้ใช้จะได้รับประสบการณ์ที่ไม่ดีนักเนื่องจากต้องไปยังหน้าต่างๆ เพื่อดูข้อมูลที่ต้องการ แต่คุณสามารถปรับปรุงประสบการณ์นี้ได้โดยการฝังและปรับแต่งแผนที่ในแอปพลิเคชันของคุณ

การเพิ่มแผนที่แบบไดนามิก (แผนที่ที่ผู้ใช้สามารถเลื่อนไปมา ซูมเข้าและออก รวมถึงดูรายละเอียดเกี่ยวกับสถานที่และจุดที่น่าสนใจต่างๆ) ลงในหน้าเว็บสามารถทำได้ด้วยโค้ดเพียงไม่กี่บรรทัด

ก่อนอื่น คุณต้องรวม Maps JavaScript API ไว้ในหน้าเว็บ ซึ่งทำได้โดยการลิงก์สคริปต์ต่อไปนี้ในหน้า HTML รวมถึง libraries=marker เพื่อให้คุณเพิ่มเครื่องหมายขั้นสูงลงในแผนที่ได้

<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a"></script>

URL อ้างอิงฟังก์ชัน JavaScript initMap ที่ทำงานเมื่อหน้าเว็บโหลด ใน URL คุณยังสามารถกำหนดภาษาหรือภูมิภาคของแผนที่เพื่อให้แน่ใจว่าแผนที่ได้รับการจัดรูปแบบอย่างถูกต้องสำหรับประเทศที่คุณกำหนดเป้าหมาย การตั้งค่าภูมิภาคยังช่วยให้มั่นใจได้ว่าลักษณะการทำงานของแอปที่ใช้นอกสหรัฐอเมริกาจะอิงตามภูมิภาคที่คุณตั้งค่าไว้ ดูรายละเอียดความครอบคลุมของ Google Maps Platform เพื่อดูรายการภาษาและภูมิภาคที่รองรับทั้งหมด และดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้พารามิเตอร์ region

ถัดไป คุณต้องมี div HTML เพื่อวางแผนที่ในหน้าเว็บ ซึ่งเป็นตำแหน่งที่จะแสดงแผนที่

<div id="map"></div>

ขั้นตอนถัดไปคือการตั้งค่าฟังก์ชันพื้นฐานของแผนที่ โดยจะทำในฟังก์ชันสคริปต์ initMap ที่ระบุไว้ใน URL ของสคริปต์ ในสคริปต์นี้ซึ่งแสดงในตัวอย่างต่อไปนี้ คุณสามารถตั้งค่าตำแหน่งเริ่มต้น, รหัสแผนที่ (จำเป็นสำหรับเครื่องหมายขั้นสูงและการจัดรูปแบบแผนที่ในระบบคลาวด์), ประเภทแผนที่ และการควบคุมที่พร้อมใช้งานในแผนที่สำหรับผู้ใช้ โปรดทราบว่า getElementById() อ้างอิงรหัส "map" div ที่อยู่ก่อนหน้า

function initMap() {
const map = new google.maps.Map(document.getElementById("map"), {
zoom: 12,
center: { lat: 51.485925, lng: -0.129500 },
mapId: "DEMO_MAP_ID",
zoomControl: false
});
}

สำหรับเครื่องระบุตำแหน่ง โดยปกติแล้วคุณจะสนใจการตั้งค่าตำแหน่งเริ่มต้น จุดศูนย์กลางหรือขอบเขต และระดับการซูม (ระดับการซูมแผนที่เข้าไปยังตำแหน่งนั้น) องค์ประกอบอื่นๆ ส่วนใหญ่ เช่น การปรับแต่งการควบคุม เป็นตัวเลือกที่คุณสามารถกำหนดระดับการโต้ตอบกับแผนที่ได้

ปรับแต่งแผนที่ของคุณ

คุณเปลี่ยนลักษณะที่ปรากฏและรายละเอียดของแผนที่ได้หลายวิธี ตัวอย่างเช่น คุณสามารถทำสิ่งต่อไปนี้ได้

  • สร้างเครื่องหมายที่กำหนดเองเพื่อแทนที่หมุดแผนที่เริ่มต้น
  • เปลี่ยนสีขององค์ประกอบในแผนที่เพื่อแสดงถึงแบรนด์ของคุณ
  • ควบคุมจุดที่น่าสนใจที่คุณแสดง (สถานที่ท่องเที่ยว อาหาร ที่พัก และอื่นๆ) และความหนาแน่นของจุดที่น่าสนใจ ซึ่งช่วยให้คุณดึงดูดความสนใจของผู้ใช้ไปยังสถานที่ตั้งของคุณได้ พร้อมกับไฮไลต์จุดสังเกตที่ช่วยให้ผู้ใช้ไปยังสถานที่ตั้งที่ใกล้ที่สุด

สร้างเครื่องหมายบนแผนที่แบบกำหนดเอง

คุณสามารถปรับแต่งเครื่องหมายขั้นสูงได้โดยเปลี่ยนสีพื้นหลัง เส้นขอบ หรือสัญลักษณ์เริ่มต้นของหมุด (เช่น เพื่อระบุว่าสถานที่เปิดอยู่หรือไม่) แทนที่เครื่องหมายด้วยรูปภาพกราฟิกที่กำหนดเอง เช่น โลโก้ของแบรนด์ หรือสร้างเครื่องหมาย HTML และ CSS ที่กำหนดเอง หน้าต่างข้อมูลหรือหน้าต่างป๊อปอัปสามารถให้ข้อมูลเพิ่มเติมแก่ผู้ใช้ เช่น เวลาทำการ หมายเลขโทรศัพท์ หรือรูปภาพ

ต่อไปนี้เป็นตัวอย่างแผนที่ที่ใช้เครื่องหมายกราฟิกที่กำหนดเอง (ดูซอร์สโค้ดใน หัวข้อเครื่องหมายกราฟิกที่กำหนดเองของ Maps JavaScript API)

ดูข้อมูลโดยละเอียดได้ในเอกสารประกอบเกี่ยวกับเครื่องหมายขั้นสูงสำหรับ JavaScript (เว็บ), Android และ iOS

จัดรูปแบบแผนที่

Google Maps Platform ช่วยให้คุณจัดรูปแบบแผนที่ในลักษณะที่ช่วยให้ผู้ใช้ค้นหาสถานที่ที่ใกล้ที่สุด ไปถึงที่นั่นโดยเร็วที่สุด และช่วยเสริมสร้างแบรนด์ของคุณ เช่น คุณสามารถเปลี่ยนสีแผนที่ให้ตรงกับการสร้างแบรนด์ และลดสิ่งรบกวนบนแผนที่ได้โดยการควบคุมจุดที่น่าสนใจที่ผู้ใช้มองเห็น นอกจากนี้ Google Maps Platform ยังมีเทมเพลตเริ่มต้นสำหรับแผนที่จำนวนมาก ซึ่งบางเทมเพลตได้รับการเพิ่มประสิทธิภาพสำหรับอุตสาหกรรมต่างๆ เช่น การท่องเที่ยว โลจิสติกส์ อสังหาริมทรัพย์ และการค้าปลีก

คุณสร้างหรือแก้ไขรูปแบบแผนที่ได้ในหน้ารูปแบบแผนที่ของคอนโซล Google Cloud ในโปรเจ็กต์

ขยายเพื่อดูภาพเคลื่อนไหวของการสร้างและการจัดรูปแบบแผนที่ในคอนโซล Cloud

รูปแบบแผนที่อุตสาหกรรม

ภาพเคลื่อนไหวนี้แสดงรูปแบบแผนที่ที่กำหนดไว้ล่วงหน้าเฉพาะอุตสาหกรรมที่คุณใช้ได้ รูปแบบเหล่านี้เป็นจุดเริ่มต้นที่เหมาะสมที่สุดสำหรับอุตสาหกรรมแต่ละประเภท ตัวอย่างเช่น รูปแบบแผนที่ค้าปลีกจะลดจุดที่น่าสนใจบนแผนที่ลง เพื่อให้ผู้ใช้มุ่งเน้นไปที่สถานที่ตั้งของคุณ รวมถึงจุดสังเกตเพื่อช่วยให้ผู้ใช้ไปยังสถานที่ตั้งที่ใกล้ที่สุดได้อย่างรวดเร็วและมั่นใจที่สุด

ในหน้าสไตล์แผนที่ เมาส์จะคลิก &quot;สร้างสไตล์แผนที่ใหม่&quot; ในหน้าสไตล์แผนที่ใหม่ ให้คลิกปุ่มตัวเลือกข้างสไตล์ที่เพิ่มประสิทธิภาพสำหรับอุตสาหกรรมต่อไปนี้ ได้แก่ การท่องเที่ยว โลจิสติกส์ อสังหาริมทรัพย์ และการค้าปลีก เมื่อคลิกแต่ละปุ่ม คำอธิบายรูปแบบแผนที่และตัวอย่างกราฟิกจะเปลี่ยนไป

การควบคุมจุดที่น่าสนใจ

ภาพเคลื่อนไหวนี้จะตั้งค่าสีเครื่องหมายสำหรับจุดที่น่าสนใจและเพิ่มความหนาแน่นของจุดที่น่าสนใจในรูปแบบแผนที่ ยิ่งความหนาแน่นสูง เครื่องหมาย POI ก็จะปรากฏบนแผนที่มากขึ้น

ในหน้าสไตล์แผนที่ เมาส์จะคลิก &quot;สร้างสไตล์แผนที่ใหม่&quot; ในหน้า &quot;รูปแบบแผนที่ใหม่&quot; ในส่วน &quot;สร้างรูปแบบของคุณเอง&quot; ระบบจะเลือกปุ่มตัวเลือก Google Maps ไว้ เมาส์คลิกปุ่มตัวเลือก Atlas สำหรับรูปแบบ Atlas จากนั้นคลิกเปิดในเครื่องมือแก้ไขรูปแบบ ในเครื่องมือแก้ไขรูปแบบ เมาส์จะคลิกฟีเจอร์จุดที่น่าสนใจ จากนั้นคลิกองค์ประกอบไอคอนเพื่อตั้งค่าสีเป็นสีแดง จากนั้นเมาส์จะเลือกช่องทำเครื่องหมายความหนาแน่นของจุดที่น่าสนใจและเลื่อนตัวควบคุมความหนาแน่นไปทางขวาเพื่อความหนาแน่นสูงสุด เครื่องหมายสีแดงจะปรากฏในตัวอย่างแผนที่มากขึ้นเรื่อยๆ เมื่อความหนาแน่นเพิ่มขึ้น จากนั้นเมาส์จะเลื่อนไปที่ปุ่มบันทึก

รูปแบบแผนที่แต่ละรูปแบบจะมีรหัสของตัวเอง หลังจากเผยแพร่สไตล์ในคอนโซล Cloud แล้ว คุณจะอ้างอิงรหัสแผนที่นั้นในโค้ด ซึ่งหมายความว่าคุณสามารถอัปเดตสไตล์แผนที่แบบเรียลไทม์ได้โดยไม่ต้องเปลี่ยนโครงสร้างภายในโค้ดของแอป รูปลักษณ์ใหม่จะปรากฏในแอปพลิเคชันที่มีอยู่โดยอัตโนมัติและใช้ในแพลตฟอร์มต่างๆ ตัวอย่างต่อไปนี้แสดงวิธีเพิ่มรหัสแผนที่ลงในหน้าเว็บโดยใช้ Maps JavaScript API

การใส่ map_ids อย่างน้อย 1 รายการใน URL ของสคริปต์จะทำให้ Maps JavaScript API แสดงสไตล์เหล่านั้นโดยอัตโนมัติเพื่อการแสดงผลแผนที่ที่รวดเร็วขึ้นเมื่อคุณเรียกใช้สไตล์เหล่านั้นในโค้ด

<script
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&map_ids=MAP_IDs&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a">
</script>

โค้ดต่อไปนี้จะแสดงแผนที่สไตล์คุณในหน้าเว็บ (ไม่แสดงองค์ประกอบ HTML <div id="map"></div> ที่แผนที่จะปรากฏในหน้าเว็บ)

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: 51.485925, lng: -0.129500},
zoom: 12,
mapId: '1234abcd5678efgh'
});

ดูข้อมูลเพิ่มเติมเกี่ยวกับการรวมการจัดรูปแบบแผนที่ในระบบคลาวด์ใน JavaScript (เว็บ), Android และ iOS

รวมข้อมูลตำแหน่งที่กำหนดเองกับรายละเอียดสถานที่

ส่วนแสดงสถานที่ตั้งของคุณบนแผนที่แบบอินเทอร์แอกทีฟก่อนหน้านี้อธิบายถึงการใช้รายละเอียดสถานที่เพื่อให้ข้อมูลที่ครบถ้วนเกี่ยวกับสถานที่ตั้งของคุณแก่ผู้ใช้ เช่น เวลาทำการ รูปภาพ และรีวิว

การทำความเข้าใจระดับราคาและ SKU ของฟิลด์ข้อมูลต่างๆ ใน Places API (ใหม่) จะเป็นประโยชน์อย่างยิ่ง กลยุทธ์หนึ่งในการจัดการต้นทุนคือการรวมข้อมูลที่คุณมีอยู่แล้วเกี่ยวกับสถานที่ตั้งของคุณเข้ากับข้อมูลใหม่จาก Google Maps เช่น การปิดชั่วคราว เวลาทำการในวันหยุด และการให้คะแนนของผู้ใช้ รูปภาพ และรีวิว หากมีข้อมูลติดต่อของร้านค้าอยู่แล้ว คุณไม่จำเป็นต้องขอข้อมูลในช่องเหล่านั้นจากรายละเอียดสถานที่ และสามารถจำกัดมาสก์ของช่องให้ดึงข้อมูลเฉพาะช่องที่ต้องการแสดงได้

คุณอาจมีข้อมูลสถานที่ของคุณเองเพื่อเสริมหรือใช้แทนรายละเอียดสถานที่ Codelab สำหรับเครื่องระบุตำแหน่งแบบฟูลสแต็กแสดงตัวอย่างการใช้ GeoJSON กับฐานข้อมูลเพื่อจัดเก็บและดึงข้อมูลรายละเอียดตำแหน่งของคุณเอง