İlk Rota Optimizasyonu isteğinizi gönderin

Bu belgede, gerçek hayattaki bir kullanım alanı senaryosunu kullanarak Rota Optimizasyonu API'sine ilk isteğinizi nasıl göndereceğiniz gösterilmektedir.

Örnekte, basitlik açısından REST API'yi göstermek için HTTP ve JSON kullanılmıştır. Ancak üretim ortamınızda, performans avantajları nedeniyle genel olarak gRPC kullanmanız önerilir. Ancak gRPC için kurulum yapılması gerekir. Daha fazla bilgi için Rota Optimizasyonu API'si istemci kitaplıkları başlıklı makaleyi inceleyin.

Senaryo

San Francisco'da 07:00-19:00 saatleri arasında köpek bakımı hizmeti veriyorsunuz. Bu sabah, şehirdeki farklı konumlardan iki köpek almanız gerekiyor. Her iki köpek sahibi de köpeklerini 07:30 ile 09:30 arasında alabileceğinizi söyledi.

İş için bir minibüsünüz var ve şoföre saatte 27 dolar ödüyorsunuz. Sürücü ve minibüs, güne saat 07:00'de kreşinizde başlar ve öğle yemeği molası için sabahki toplama işlemlerinden saat 12:00'ye kadar dönmüş olmaları gerekir.

Bugün 13 Şubat 2024 ve sürücünün aşağıdaki görevleri var:

• Coit Kulesi'nin yakınındaki Bernese dağ köpeğini alın.
• South Sunset Playground Park'ta Chihuahua'yı teslim alın.
• İki köpeği de Mission Dolores Park'taki köpek kreşine bırakın.

Köpeklerin araçta geçirdiği süreyi en aza indiren ve teslim alma ile bırakma şartlarını karşılayan bir rota belirlemeniz gerekiyor.

Başlamadan önce

Bu örnek senaryodaki kodu çalıştırmak için öncelikle Rota Optimizasyonu API'sini ayarlama bölümündeki talimatları tamamlamanız gerekir.

1. Rota optimizasyonu yaklaşımınızı seçme

Route Optimization API, optimizasyon sorununuzun karmaşıklığına bağlı olarak seçebileceğiniz birden fazla yöntem sunar.

Bu köpek kreşi senaryosu küçük ve basit bir istek olduğundan, küçük istekler için hızlı sonuçlar veren optimizeTours gibi bir engelleme yöntemi kullanın. Rota Optimizasyonu API yöntemleri hakkında daha fazla bilgi için Eşzamanlı ve eşzamansız uç noktalar başlıklı makaleyi inceleyin.

optimizeTours yöntemine HTTP POST isteği göndermek için aşağıdaki URL'yi kullanın:

https://routeoptimization.googleapis.com/v1/projects/PROJECT_OR_ID:optimizeTours

Gereksiz bekleme süresini azaltmak için zaman aşımı ve son tarih ayarlarını kısa tutmanız da gerekir. Bu köpek bakım merkezi senaryosunda, optimize edicinin isteğinize yanıt vermek için çok fazla zamana ihtiyacı yoktur. Bu nedenle aşağıdaki ayarları kullanın:

• timeout parametresini 2 saniye olarak ayarlayın.
• Son tarih ayarlarını varsayılan değerde bırakın. Bu değer, REST istekleri için 60 saniyedir.

2. İstek e-posta mesajını oluşturma

Engelleme optimizeTours yöntemini seçip zaman aşımı ve son tarih ayarlarını tanımladıktan sonraki adımınız, istek mesajının gövdesini oluşturmaktır.

Bu senaryoda istek, REST API'de JSON olarak kodlanmış bir OptimizeToursRequest mesajıdır.

İstek mesajını oluşturmak için sonraki adımları uygulayın:

1. Temel istek yapısıyla başlayın:

   {
     "timeout": ...,
     "model": {
       "shipments": [...],
       "vehicles": [...],
       "globalStartTime": "...",
       "globalEndTime": "..."
     }
   }
   

   Yapı hakkında daha fazla bilgi için Temel yapı (ShipmentModel, Shipment ve Vehicle) ile ilgili temel kavramlar kılavuzuna bakın.

2. Gönderimleri tanımlayın. shipments alanına, sabah alınması ve bırakılması gereken her köpek için bir Shipment mesajı ekleyin. Burada, köpek sahibinin tercih ettiği teslim alma konumunu ve saatlerini, köpeklerin bırakılacağı kreşin konumunu ve saatlerini tanımlarsınız.

   1. Her köpek için teslim alma ve teslim etme (bu senaryoda kreşe bırakma olarak adlandırılır) işlemlerine yönelik birer VisitRequest oluşturun.

      • Teslim alma bölümünde arrivalWaypoint değerini köpeğin teslim alınacağı konum (Bernese dağ köpeği için Coit Tower veya Chihuahua için South Sunset Playground Park) ve timeWindows değerini sahibinin talep ettiği teslim alma saati (07:30-09:30) olarak ayarlayın.

      • Teslimatlarda arrivalWaypoint simgesini kreş olarak, timeWindows simgesini ise gerekli teslimat zamanı (09:30-11:30) olarak ayarlayın.

      Zaman aralıkları hakkında daha fazla bilgi için Zaman aralıkları başlıklı makaleyi inceleyin.

   2. Her gönderi için "Bernese dağ köpeği" ve "Chihuahua" gibi bir tanımlayıcı eklemek üzere label alanını kullanabilirsiniz. Bu, yanıttaki gönderileri belirlemenize yardımcı olabilir.

   Gönderileri tanımlama hakkında daha fazla bilgi için Gönderi bölümüne bakın.

3. Araçları tanımlayın. vehicles alanına, başlangıç ve bitiş noktaları kreş olan bir minibüsünüz için bir Vehicle mesajı, sürücünün ücretini ve minibüsün çalışma saatlerini ekleyin.

   1. Minibüsün startWaypoint ve endWaypoint değerlerini, günün başlangıç ve bitiş konumları olan Mission Dolores Parkı'nın yakınındaki kreş olarak ayarlayın.

   2. İşletme maliyetlerinizi en aza indirmek için işletmenizin maliyet kısıtlamalarını tanımlamanız gerekir. Maliyet parametresini costPerHour 27 olarak ayarlayın. Bu tutar, köpek kreşi minibüsünü kullandığı için sürücüye ödediğiniz ücrettir. Maliyet parametreleri hakkında daha fazla bilgi için Maliyet modeli başlıklı makaleyi inceleyin.

   3. Optimize edicinin, minibüsün çalışma saatleri içinde bir rota oluşturmasını sağlamak için startTimeWindows değerini, sürücünün minibüsü kullanmaya başlaması için kabul edilebilir aralığa ve endTimeWindows değerini, sürücünün kreşe dönmesi gereken kabul edilebilir aralığa ayarlayın. Zaman aralıkları hakkında daha fazla bilgi için Zaman aralıkları başlıklı makaleyi inceleyin.

   Araçları tanımlama hakkında daha fazla bilgi için Araç bölümüne bakın.

4. Genel bir zaman aralığı ayarlayın. Genel zaman aralığı, minibüsün gün boyunca kreşiniz için alma ve bırakma işlemlerini gerçekleştirebileceği zaman aralığını temsil eder. Bu senaryo için globalStartTime seçeneğini 13 Şubat 2024'te 07:00, globalEndTime seçeneğini ise 19:00 olarak ayarlayın. Bu saatler, köpek bakım merkezinin çalışma saatlerini gösterir.

3. İsteği gönder

Aşağıda, köpek bakım merkezi senaryosuna dayalı basit bir curl isteği verilmiştir. Bu istekte, engelleyici optimizeTours yöntemi kullanılır.

İsteği göndermeden önce örnek koddaki PROJECT_NUMBER_OR_ID yerine Google Cloud proje kimliğinizi yazın.

curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeTours' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
--data @- << EOM
{
  "timeout": "2s",
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.802395,
                  "longitude": -122.405822
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T07:30:00Z",
                "endTime": "2024-02-13T09:30:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.760202,
                  "longitude": -122.426796
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T09:30:00Z",
                "endTime": "2024-02-13T11:30:00Z"
              }
            ]
          }
        ],
        "label": "Bernese mountain dog"
      },
      {
        "pickups": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.738067,
                  "longitude": -122.498593
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T07:30:00Z",
                "endTime": "2024-02-13T09:30:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalWaypoint": {
              "location": {
                "latLng": {
                  "latitude": 37.760202,
                  "longitude": -122.426796
                }
              }
            },
            "timeWindows": [
              {
                "startTime": "2024-02-13T09:30:00Z",
                "endTime": "2024-02-13T11:30:00Z"
              }
            ]
          }
        ],
        "label": "Chihuahua"
      }
    ],
    "vehicles": [
      {
        "startWaypoint": {
          "location": {
            "latLng": {
              "latitude": 37.760202,
              "longitude": -122.426796
            }
          }
        },
        "endWaypoint": {
          "location": {
            "latLng": {
              "latitude": 37.760202,
              "longitude": -122.426796
            }
          }
        },
        "costPerHour": 27,
        "startTimeWindows": [
          {
            "startTime": "2024-02-13T07:00:00Z",
            "endTime": "2024-02-13T07:15:00Z"
          }
        ],
        "endTimeWindows": [
          {
            "startTime": "2024-02-13T11:45:00Z",
            "endTime": "2024-02-13T12:00:00Z"
          }
        ]
      }
    ],
    "globalStartTime": "2024-02-13T07:00:00Z",
    "globalEndTime": "2024-02-13T19:00:00Z"
  }
}
EOM

İstekte kullanılan istek parametreleri

Aşağıdaki tabloda, örnek senaryonun istek gövdesinde kullanılan istek parametreleri açıklanmaktadır. İçerikleri üst öğeye veya metin aramasına göre filtreleyebilirsiniz.

Sonraki

Yanıtı yorumlamaarrow_forward