Prasyarat

Sebelum Anda mulai menghitung rute, ikuti langkah-langkah prasyarat:

Buat sumber daya kalkulator rute

Sebelum Anda dapat menghitung rute, buat sumber kalkulator rute di AWS akun Anda.

Saat membuat sumber kalkulator rute, Anda dapat memilih dari penyedia data yang tersedia:

1. Esri — Untuk informasi lebih lanjut tentang cakupan Esri di wilayah minat Anda, lihat detail Esri di jaringan jalan dan cakupan lalu lintas.

2. HERE Technologies — Untuk informasi lebih lanjut tentang cakupan HERE di wilayah yang Anda minati, lihat cakupan perutean mobil DI SINI dan cakupan perutean truk HERE.

3. Grab — Untuk informasi selengkapnya tentang cakupan Grab, lihatNegara/wilayah dan area yang dicakup.

catatan

Jika aplikasi Anda melacak atau merutekan aset yang Anda gunakan dalam bisnis Anda, seperti kendaraan pengiriman atau karyawan, Anda tidak boleh menggunakan Esri sebagai penyedia geolokasi Anda. Lihat bagian 82 dari ketentuan AWS layanan untuk detail selengkapnya.

Anda dapat melakukannya menggunakan konsol Amazon Location Service, theAWS CLI, atau Amazon Location API.

Console

Untuk membuat sumber daya kalkulator rute menggunakan konsol Lokasi Amazon

1. Buka konsol Lokasi Amazon di https://console.aws.amazon.com/location/.

2. Di panel navigasi kiri, pilih Kalkulator rute.

3. Pilih Buat kalkulator rute.

4. Isi kotak-kotak berikut:

   • Nama — Masukkan nama untuk sumber kalkulator rute. Misalnya, ExampleCalculator. Maksimal 100 karakter. Entri yang valid termasuk karakter alfanumerik, tanda hubung, titik, dan garis bawah.

   • Deskripsi - Masukkan deskripsi opsional.

5. Untuk penyedia data, pilih penyedia data untuk digunakan sebagai kalkulator rute.

6. (Opsional) Di bawah Tag, masukkan tag Kunci dan Nilai. Ini menambahkan tag sumber kalkulator rute baru Anda. Untuk informasi selengkapnya, lihat Menandai sumber daya Anda.

7. Pilih Buat kalkulator rute.

API

Untuk membuat sumber daya kalkulator rute menggunakan Amazon Location API

Gunakan CreateRouteCalculator operasi dari Amazon Location Places API.

Contoh berikut adalah permintaan API untuk membuat sumber daya kalkulator rute yang disebut ExampleCalculatormenggunakan penyedia data Esri.

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

Untuk membuat sumber daya kalkulator rute menggunakan AWS CLI perintah

Gunakan perintah create-route-calculator.

Contoh berikut membuat sumber kalkulator rute yang disebut ExampleCalculatormenggunakan Esri sebagai penyedia data.

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --tags Tag1=Value1

catatan

Penagihan tergantung pada penggunaan Anda. Anda mungkin dikenakan biaya untuk penggunaan AWS layanan lain. Untuk informasi selengkapnya, lihat harga Amazon Location Service.

Mengautentikasi permintaan Anda

Setelah Anda membuat sumber daya kalkulator rute dan Anda siap untuk mulai membangun fitur lokasi ke dalam aplikasi Anda, pilih bagaimana Anda akan mengautentikasi permintaan Anda:

• Untuk mempelajari cara mengakses layanan, lihat Mengakses Amazon Location Service.

• Jika Anda memiliki situs web dengan pengguna anonim, Anda mungkin ingin menggunakan Kunci API atau Amazon Cognito.

  Contoh

  Contoh berikut menunjukkan penggunaan kunci API untuk otorisasi, menggunakan AWS JavaScript SDK v3, dan Lokasi Amazon. JavaScript Pembantu otentikasi

  import { LocationClient, CalculateRouteCommand } from "@aws-sdk/client-location";
  import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
  
  const apiKey = "v1.public.your-api-key-value"; // API key
  
  // Create an authentication helper instance using an API key
  const authHelper = await withAPIKey(apiKey);
  
  const client = new LocationClient({
    region: "<region>", // region containing Cognito pool
    ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
  });
  
  const input = {
    CalculatorName: "ExampleCalculator",
    DeparturePosition: [-123.4567, 45.6789],
    DestinationPosition: [-123.123, 45.234],
  };
  
  const command = new CalculateRouteCommand(input);
  
  const response = await client.send(command);