openapi: 3.1.1
info:
  title: Place
  version: 2.0.0
  description: Schema definition for the Place entity in the Beckn Logistics domain.
  license:
    name: CC-BY-NC-SA 4.0 International
  contact:
    name: Beckn Labs
    url: https://beckn.io
components:
  schemas:
    LogisticsPlace:
      x-iri: https://schema.nfh.global/LogisticsPlace/v2.0
      type: object
      title: Place
      description: 'A geographic location relevant to logistics such as origin, destination, hub, or waypoint. Includes structured address and GPS coordinates. Maps to beckn:Location and schema:Place.

        '
      required:
      - id
      properties:
        id:
          type: string
          example: PLC-BLR-001
        name:
          type: string
          description: Name of the place
          example: Anita's Home
        type:
          type: string
          enum:
          - PICKUP
          - DELIVERY
          - HUB
          - WAYPOINT
          - STORE
          - WAREHOUSE
          example: DELIVERY
        address:
          type: object
          properties:
            line1:
              type: string
              example: 42, 5th Cross Road
            line2:
              type: string
              example: Indiranagar
            landmark:
              type: string
              example: Near Total Mall
            city:
              type: string
              example: Bengaluru
            state:
              type: string
              example: Karnataka
            country:
              type: string
              example: India
            pincode:
              type: string
              example: '560038'
        gps:
          type: object
          properties:
            lat:
              type: number
              example: 12.9719
            lng:
              type: number
              example: 77.6412
        contact:
          $ref: https://schema.nfh.global/Contact/v2.0/attributes.yaml#/components/schemas/Contact
        accessInstructions:
          type: string
          description: Instructions for courier to reach the place
          example: Ring bell twice. Building B, 3rd floor.
        isVerified:
          type: boolean
          description: Whether the address has been geocode-verified
          example: true