Prasyarat untuk menghitung rute menggunakan Lokasi Amazon - Amazon Location Service
Buat sumber daya kalkulator ruteMengautentikasi permintaan Anda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Prasyarat untuk menghitung rute menggunakan Lokasi Amazon

Halaman ini menguraikan prasyarat untuk memulai fitur perutean layanan, yang memungkinkan Anda menghitung rute dan waktu perjalanan yang dioptimalkan antara beberapa lokasi. Ini mencakup topik-topik penting, seperti mengonfigurasi izin akses, menyiapkan sumber daya yang diperlukan dalam AWS akun Anda, dan dependensi atau alat tambahan apa pun yang diperlukan berdasarkan kasus penggunaan atau lingkungan pengembangan khusus Anda.

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. HERETeknologi — Untuk informasi lebih lanjut tentang HERE cakupan di wilayah yang Anda minati, lihat cakupan perutean HERE mobil dan cakupan perutean HERE truk.

  3. Grab — Untuk informasi lebih lanjut 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, the AWS CLI, atau Amazon LocationAPIs.

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 Lokasi Amazon APIs

Gunakan CreateRouteCalculator operasi dari Tempat Lokasi AmazonAPIs.

Contoh berikut adalah API permintaan untuk membuat sumber kalkulator rute yang disebut ExampleCalculator menggunakan 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 ExampleCalculator memakai 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 API Keys atau Amazon Cognito.

    Contoh

    Contoh berikut menunjukkan penggunaan API kunci untuk otorisasi, menggunakan AWS JavaScriptSDKv3, 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);